Skip to main content
Diese Dokumentation beschreibt, wie Sie Logging mit der AppSignal for Go-Integration konfigurieren.

​
Logging konfigurieren

🔐 Senden Sie keine personenbezogenen Daten (Personal Identifiable Information, PII) an AppSignal. Filtern Sie PII (z. B. Namen, E-Mail-Adressen) aus Logs und verwenden Sie stattdessen eine ID, einen Hash oder einen pseudonymisierten Bezeichner.

Für HIPAA-pflichtige Stellen finden Sie weitere Informationen zum Abschluss eines Business Associate Agreement (BAA) in unserer Business Add-Ons-Dokumentation.
Sie müssen keine Log-Quelle erstellen, um Logs aus der AppSignal for Go-Integration zu senden. Eine “application”-Log-Quelle wird automatisch erstellt. Die Go-Integration nutzt die Logging-Funktionen von OpenTelemetry, um Logs an AppSignal zu senden.

​
Eigenständige Verwendung

Um Logging mit OpenTelemetry in Go zu verwenden, müssen Sie den Logger mithilfe des OpenTelemetry-Logger-Providers einrichten. 
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"),
	})
}

​
Verwendung mit slog

Sie können das Standardpaket slog so konfigurieren, dass es strukturierte Logs über den OpenTelemetry-Handler an AppSignal sendet. 
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")
}

​
Verwendung

​
Logs senden

Mit dem OpenTelemetry-Logger direkt können Sie die Severity-Stufe Ihrer Logs definieren: 
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"),
	})
}
Sie können benutzerdefinierte Attribute definieren, um Log-Informationen zu senden, die beim Filtern und Abfragen von Logs verwendet werden können: 
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),
		},
	})
}
Sie können Nachrichteninhalte und Attributwerte aus dem Log-Management-Tool heraus abfragen und filtern. Nach der Konfiguration werden die gewünschten Attribute als Log-Tags an AppSignal gesendet und sind in der AppSignal Logging-Oberfläche abfragbar.

​
Logs filtern

Sie können die Konfigurationsoption ignore_logs verwenden, um Log-Zeilen zu ignorieren. Lesen Sie unseren Leitfaden zum Ignorieren von Logs, um mehr zu erfahren.

​
Brauchen Sie Hilfe?

Nachdem Sie Ihre Go-Anwendung so konfiguriert haben, dass sie Logs sendet, sollten die Logs in AppSignal erscheinen. Wenn Sie sich bei diesem Schritt unsicher sind oder AppSignal keine Logs empfängt, können Sie sich jederzeit für Unterstützung an uns wenden. Wir helfen Ihnen, wieder auf Kurs zu kommen!