Skip to main content
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.
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. 
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. 
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 : 
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 : 
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. 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 pour ignorer les lignes de journal. Consultez notre guide 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 pour obtenir de l’aide. Nous vous aiderons à remettre les choses sur la bonne voie !