;
};
Cette documentation décrit comment configurer la journalisation avec l'intégration AppSignal for Go.
## Configurer la journalisation
🔐 N'envoyez pas d'informations personnelles identifiables (PII) à AppSignal. Filtrez les PII (par exemple, noms, e-mails) des journaux et utilisez un identifiant, un hash ou un identifiant pseudonymisé à la place.
Pour les **entités couvertes par la HIPAA**, plus d'informations sur la signature d'un Business Associate Agreement (BAA) sont disponibles dans notre [documentation Business Add-Ons](/support/business-add-ons).
Vous n'avez pas besoin de créer une source de journaux pour envoyer des journaux depuis l'intégration AppSignal for Go. Une source de journaux "application" sera créée automatiquement.
L'intégration Go utilise les capacités de journalisation d'OpenTelemetry pour envoyer des journaux à AppSignal.
### Utilisation autonome
Pour utiliser la journalisation avec OpenTelemetry en Go, vous devez configurer le logger en utilisant le logger provider d'OpenTelemetry.
```go Go theme={null}
package main
import (
"context"
"go.opentelemetry.io/otel"
"go.opentelemetry.io/otel/log"
)
func main() {
// Get the logger from the global logger provider
loggerProvider := otel.GetLoggerProvider()
logger := loggerProvider.Logger("my-app")
// Log a message
logger.Emit(context.Background(), log.Record{
Severity: log.SeverityInfo,
Body: log.StringValue("Log message line"),
})
}
```
### Utilisation avec `slog`
Vous pouvez configurer le package standard `slog` pour envoyer des journaux structurés à AppSignal en utilisant le handler OpenTelemetry.
```go Go theme={null}
package main
import (
"context"
"log/slog"
"go.opentelemetry.io/contrib/bridges/otelslog"
)
func main() {
// Create an OpenTelemetry `slog` handler
otelHandler := otelslog.NewHandler("my-app")
// Create a `slog` logger with the OpenTelemetry handler
logger := slog.New(otelHandler)
// Use the logger
logger.Info("Log message line")
logger.With("user_id", 123).Info("User logged in")
logger.Error("An error occurred", "error", "database connection failed")
}
```
## Utilisation
### Envoi de journaux
En utilisant directement le logger OpenTelemetry, vous pouvez définir le niveau de sévérité de vos journaux :
```go Go theme={null}
package main
import (
"context"
"go.opentelemetry.io/otel"
"go.opentelemetry.io/otel/log"
)
func main() {
loggerProvider := otel.GetLoggerProvider()
logger := loggerProvider.Logger("my-app")
// Different severity levels
logger.Emit(context.Background(), log.Record{
Severity: log.SeverityWarn,
Body: log.StringValue("Something went wrong"),
})
logger.Emit(context.Background(), log.Record{
Severity: log.SeverityInfo,
Body: log.StringValue("Action completed"),
})
logger.Emit(context.Background(), log.Record{
Severity: log.SeverityError,
Body: log.StringValue("Database connection failed"),
})
}
```
Vous pouvez définir des attributs personnalisés pour envoyer des informations de journal qui peuvent être utilisées lors du filtrage et de l'interrogation des journaux :
```go Go theme={null}
package main
import (
"context"
"go.opentelemetry.io/otel"
"go.opentelemetry.io/otel/log"
)
func processInvoice(customerID string) {
loggerProvider := otel.GetLoggerProvider()
logger := loggerProvider.Logger("invoice_helper")
logger.Emit(context.Background(), log.Record{
Severity: log.SeverityInfo,
Body: log.StringValue("Generating invoice for customer"),
Attributes: []log.KeyValue{
log.String("customer_id", customerID),
},
})
invoice := generateInvoice(customerID)
logger.Emit(context.Background(), log.Record{
Severity: log.SeverityInfo,
Body: log.StringValue("Generated invoice for customer"),
Attributes: []log.KeyValue{
log.String("customer_id", customerID),
log.String("invoice_id", invoice.ID),
},
})
}
```
Vous pouvez interroger et filtrer le contenu des messages et les valeurs d'attribut depuis l'outil [Log Management](/logging/log-management).
Une fois configurés, les attributs souhaités seront envoyés à AppSignal en tant que tags de journal, et seront interrogeables dans l'interface de journalisation d'AppSignal.
## Filtrage des journaux
Vous pouvez utiliser [l'option de configuration `ignore_logs`](/go/configuration#option-ignore_logs) pour ignorer les lignes de journal. Consultez [notre guide Ignore Logs](/guides/filter-data/ignore-logs) pour en savoir plus.
## Besoin d'aide ?
Après avoir configuré votre application Go pour envoyer des journaux, les journaux devraient apparaître dans AppSignal. Si vous avez des doutes sur cette étape ou si AppSignal ne reçoit aucun journal, vous pouvez toujours [nous contacter](mailto:support@appsignal.com) pour obtenir de l'aide. Nous vous aiderons à remettre les choses sur la bonne voie !