;
};
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](/support/business-add-ons).
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.
```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"),
})
}
```
### Verwendung mit `slog`
Sie können das Standardpaket `slog` so konfigurieren, dass es strukturierte Logs über den OpenTelemetry-Handler an AppSignal sendet.
```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")
}
```
## Verwendung
### Logs senden
Mit dem OpenTelemetry-Logger direkt können Sie die Severity-Stufe Ihrer Logs definieren:
```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"),
})
}
```
Sie können benutzerdefinierte Attribute definieren, um Log-Informationen zu senden, die beim Filtern und Abfragen von Logs verwendet werden können:
```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),
},
})
}
```
Sie können Nachrichteninhalte und Attributwerte aus dem [Log-Management](/logging/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`](/go/configuration#option-ignore_logs) verwenden, um Log-Zeilen zu ignorieren. Lesen Sie [unseren Leitfaden zum Ignorieren von Logs](/guides/filter-data/ignore-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](mailto:support@appsignal.com). Wir helfen Ihnen, wieder auf Kurs zu kommen!