Go -Collector konfigurieren

Für die meisten Anwendungsfälle ist es ausreichend, den Instana Go Collector nur mit instana.NewSensor() zu initialisieren und die Standardkonfigurationsoptionen beizubehalten. Sie können bei der Initialisierung des Instana Go Collector auch ein Konfigurationsobjekt übergeben:

sensor := instana.NewSensorWithTracer(
        instana.NewTracerWithOptions(&instana.Options{
                // ...
        },
)
 

Das instana.Options Konfigurationsobjekt bietet folgende Felder zur Konfiguration des Collectors:

• Service - globaler Servicename, der zum Identifizieren des Programms im Instana-Back-End verwendet wird.
• AgentHost, AgentPort - Standardwert für localhost:42699, legt die Koordinaten des Instana-Proxy-Agenten fest.
• LogLevel - Error, Warn, Info oder Debug
• EnableAutoProfile - Aktiviert die automatische Erstellung von Prozessprofilen, wenn true
• MaxBufferedSpans - Die maximale Anzahl von Bereichen zum Puffer
• ForceTransmissionStartingAt - Die Anzahl der Bereiche, die erfasst werden sollen, bevor der Puffer zum Agenten gelöscht wird.
• MaxBufferedProfiles - Die maximale Anzahl von Profilen zum Puffer
• IncludeProfilerFrames - ob Profiler-Aufrufe in das Profil aufgenommen werden sollen oder nicht
• Tracer - Tracerspezifische Konfiguration , die von allen Tracerinstanzen verwendet wird

Die meisten dieser Werte können auch über Um gebungsvariablen festgelegt werden. Die Konfiguration im App-Code hat Vorrang vor den Umgebungsvariablen mit Ausnahme der folgenden Einstellungen:

• INSTANA_SERVICE_NAME ermöglicht das Überschreiben des Servicenamens, der im Code festgelegt ist.
• INSTANA_PROCESS_NAME ermöglicht die Überschreibung des Namens für die Infrastrukturentität, die den Go-Prozess darstellt.
• INSTANA_DEBUG aktiviert Debugprotokolle auch dann, wenn die Konfiguration im App-Code eine höhere Protokollierungsstufe definiert.
• INSTANA_AUTO_PROFILE ermöglicht die fortlaufende Profilerstellung mit AutoProfile™

Um den „ Instana “ Go Collector zur Überwachung eines Dienstes zu verwenden, der in einer serverlosen Umgebung wie AWS Fargate oder Google Cloud Run ausgeführt wird, stellen Sie sicher, dass die INSTANA_AGENT_KEY Umgebungsvariablen und in Ihrer INSTANA_ENDPOINT_URL Aufgabendefinition gesetzt sind. Beachten Sie, dass die env-Variablen INSTANA_AGENT_HOST und INSTANA_AGENT_PORT in diesem Fall ignoriert werden. Eine ausführliche Anleitung dazu finden Sie im entsprechenden Abschnitt der Dokumentation unter Instana :

• Konfigurieren von Aufgaben-Definitionen für „ AWS Fargate “
• AWS Lambda -Funktionen konfigurieren
• Google Cloud Run -Dienste konfigurieren
• Microsoft Azure -Funktionen konfigurieren

Dienste, die in serverlosen Umgebungen ausgeführt werden, verwenden keinen Host-Agenten, um Metriken und Trace-Daten an das Backend von „ Instana “ zu senden; daher ist die übliche Methode zur Konfiguration des In-App-Sensors über configuration.yaml eine Konfigurationsdatei hier nicht anwendbar. Stattdessen gibt es eine Gruppe von Umgebungsvariablen, die optional in der Service-Taskdefinition konfiguriert werden können:

• INSTANA_TIMEOUT
• INSTANA_SECRETS
• INSTANA_EXTRA_HTTP_HEADERS
• INSTANA_ENDPOINT_PROXY
• INSTANA_TAGS
• INSTANA_ZONE

Eine ausführlichere Beschreibung dieser Variablen und ihres Wertformats finden Sie im Abschnitt „Serverless Monitoring “.

Sie können das Format der „ Kafka “-Trace-Korrelations-Header, die vom „ Go “-Tracer verwendet werden, über die Umgebungsvariable INSTANA_KAFKA_HEADER_FORMATkonfigurieren. Gültige Werte sind binary, stringoder both.

Eine weitere Möglichkeit besteht darin, das Format des Trace-Korrelations-Headers „ Kafka “ auf der Ebene des Host-Agenten „ Instana “ zu konfigurieren.

Weitere Informationen finden Sie unter Kafka -Headermigration.