Skip to main content
AppSignal kann über OpenTelemetry-Ressourcenattribute konfiguriert werden. Auf dieser Seite beschreiben wir, wie Ressourcenattribute konfiguriert werden und welche Attribute gesetzt werden können.

OpenTelemetry-Ressourcenattribute konfigurieren

Sie können OpenTelemetry mithilfe von Ressourcenattributen so konfigurieren, dass es Daten an AppSignal sendet. Ressourcenattribute sind Attribute, die für jeden Trace gelten, der von der Anwendung über OpenTelemetry gemeldet wird. Sie können Ressourcenattribute in Ihrer OpenTelemetry-Konfigurationsdatei konfigurieren. Dort müssen Sie auch den OpenTelemetry-Exporter so einrichten, dass er Daten an den AppSignal Collector sendet.

App-Name

  • Attributname: appsignal.config.name
  • Oder als Anforderungsheader: Appsignal-Config-Name
  • Typ: String
  • Erforderlich: Ja
Name Ihrer Anwendung, wie er auf AppSignal.com angezeigt werden soll.

App-Umgebung

  • Attributname: appsignal.config.environment
  • Oder als Anforderungsheader: Appsignal-Config-Environment
  • Typ: String
  • Erforderlich: Ja
Die Umgebung der Anwendung, wie sie auf AppSignal.com angezeigt werden soll.

Push API-Schlüssel

  • Attributname: appsignal.config.push_api_key
  • Oder als Anforderungsheader: Appsignal-Config-PushApiKey
  • Typ: String
  • Erforderlich: Ja
Der Authentifizierungsschlüssel auf Organisationsebene zur Authentifizierung bei unserer Push API. Detaillierte Informationen zum AppSignal Push API-Schlüssel finden Sie in unserer Terminologie-Dokumentation.

App-Revision

  • Attributname: appsignal.config.revision
  • Oder als Anforderungsheader: Appsignal-Config-Revision
  • Typ: String
  • Erforderlich: Ja
Um neue Deployments von OpenTelemetry-Anwendungen zu melden, können Sie Deploy Markers verwenden. Deploy Markers können mit dem Revisions-Ressourcenattribut konfiguriert werden. Der Wert dieses Attributs wird verwendet, um neue Deployments zu identifizieren. Er muss pro Deployment eindeutig sein, damit neue Deployments erkannt werden. Wir empfehlen die Verwendung von Git-Commit-SHAs oder eines Tags in Ihrem SCM. Dies kann in Kombination mit unseren Backtrace-Links verwendet werden, um direkt von AppSignal zum Quellcode auf Plattformen wie GitHub und GitLab zu verlinken.

Sprachintegration

  • Attributname: appsignal.config.language_integration
  • Oder als Anforderungsheader: Appsignal-Config-LanguageIntegration
  • Typ: String
  • Erforderlich: Ja
AppSignal verwendet das Ressourcenattribut language_integration, um die Sprache eines Traces zu erkennen und Exception-Backtraces korrekt zu parsen. Um diese Option festzulegen, geben Sie den Sprachnamen in Kleinbuchstaben an, z. B. “python”, “rust”, “ruby”, “elixir”, “go” und “nodejs”.

OTP-App-Name

  • Attributname: appsignal.config.otp_app
  • Typ: String
  • Erforderlich: Ja, für Elixir-Apps
AppSignal verwendet das Ressourcenattribut appsignal.config.otp_app, um zu erkennen, welche Backtrace-Zeilen von Fehlern zur Anwendung gehören. Sie finden den OTP-App-Namen für Ihre Anwendung, indem Sie IO.inspect(:application.get_application()) in Ihrer Anwendung aufrufen und die Ausgabe überprüfen.

Service-Name

  • Attributname: service.name
  • Oder als Anforderungsheader: OpenTelemetry-ServiceName
  • Typ: String
  • Erforderlich: Ja
Das Ressourcenattribut service.name hilft AppSignal, verschiedene Dienste für Traces zu erkennen und gruppiert die Traces automatisch in einem Namespace basierend auf dem Service-Namen. Wählen Sie einen Namen, der zu Ihrer Anwendung passt, wie “Web server”, “Background worker”, “Email service”, “Authentication service” usw.

Hostname

  • Attributname: host.name
  • Oder als Anforderungsheader: OpenTelemetry-HostName
  • Typ: String
  • Erforderlich: Ja
Das Ressourcenattribut host.name hilft AppSignal, verschiedene Hosts für Traces zu erkennen und kennzeichnet die Traces automatisch mit dem Hostnamen.

App-Pfad

  • Attributname: appsignal.config.app_path
  • Typ: String
  • Erforderlich: Nein
Der Speicherort der App im Dateisystem des Hosts. Das Ressourcenattribut app_path hilft AppSignal, Backtraces zu bereinigen, indem der absolute App-Pfad aus den Backtrace-Zeilen entfernt wird. Auf diese Weise werden nur Pfade innerhalb des Kontexts des Projektverzeichnisses angezeigt. Dies macht unsere Funktion Backtrace-Links möglich.

Attribute filtern

  • Attributname: appsignal.config.filter_attributes
  • Typ: Array
  • Erforderlich: Nein
Mit dem Ressourcenattribut filter_attributes können Sie bestimmte Attribute davon ausschließen, an AppSignal gemeldet zu werden. Dies kann nützlich sein, um sensible oder nicht relevante Informationen herauszufiltern. Wenn ein Attribut auf diese Weise gefiltert wird, erscheint es überhaupt nicht in der Benutzeroberfläche.

Funktionsparameter filtern

  • Attributname: appsignal.config.filter_function_parameters
  • Typ: Array
  • Standardwert: Leer
  • Erforderlich: Nein
Mit dem Ressourcenattribut filter_function_parameters können Sie alle Funktionsparameter herausfiltern, die im Span-Attribut appsignal.function.parameters gesetzt sind. Im Beispiel unten werden die Werte für die in der Konfigurationsoption filter_function_parameters aufgeführten Schlüssel durch [FILTERED] ersetzt.

Request-Query-Parameter filtern

  • Attributname: appsignal.config.filter_request_query_parameters
  • Typ: Array
  • Standardwert: Leer
  • Erforderlich: Nein
Mit dem Ressourcenattribut filter_request_query_parameters können Sie alle Request-Query-Parameter herausfiltern, die im Span-Attribut appsignal.request.query_parameters gesetzt sind. Im Beispiel unten werden die Werte für die in der Konfigurationsoption filter_request_query_parameters aufgeführten Schlüssel durch [FILTERED] ersetzt.

Request-Payload filtern

  • Attributname: appsignal.config.filter_request_payload
  • Typ: Array
  • Standardwert: Leer
  • Erforderlich: Nein
Mit dem Ressourcenattribut filter_request_payload können Sie alle Request-Payload-Daten herausfiltern, die im Span-Attribut appsignal.request.payload gesetzt sind. Im Beispiel unten werden die Werte für die in der Konfigurationsoption filter_request_payload aufgeführten Schlüssel durch [FILTERED] ersetzt.

Request-Session-Daten filtern

  • Attributname: appsignal.config.filter_request_session_data
  • Typ: Array
  • Standardwert: Leer
  • Erforderlich: Nein
Mit dem Ressourcenattribut filter_request_session_data können Sie alle Request-Session-Daten herausfiltern, die im Span-Attribut appsignal.request.session_data gesetzt sind. Im Beispiel unten werden die Werte für die in der Konfigurationsoption filter_request_session_data aufgeführten Schlüssel durch [FILTERED] ersetzt.

Aktionen ignorieren

  • Attributname: appsignal.config.ignore_actions
  • Typ: Array of Strings
  • Erforderlich: Nein
Mit dem Ressourcenattribut ignore_actions können Sie bestimmte Aktionen davon ausschließen, an AppSignal gemeldet zu werden. Dies kann nützlich sein, um Health-Check-Endpunkte oder andere Aktionen zu ignorieren, die Sie nicht überwachen möchten.

Fehler ignorieren

  • Attributname: appsignal.config.ignore_errors
  • Typ: Array of Strings
  • Erforderlich: Nein
Mit dem Ressourcenattribut ignore_errors können Sie bestimmte Fehler davon ausschließen, an AppSignal gemeldet zu werden. Dies kann nützlich sein, um erwartete Fehler oder Fehler zu ignorieren, die nicht behoben werden können.

Namespaces ignorieren

  • Attributname: appsignal.config.ignore_namespaces
  • Typ: Array of Strings
  • Erforderlich: Nein
Mit dem Ressourcenattribut ignore_namespaces können Sie bestimmte Namespaces davon ausschließen, an AppSignal gemeldet zu werden. Dies kann nützlich sein, um bestimmte Teile Ihrer Anwendung von der Überwachung auszuschließen.

Response-Header

  • Attributname: appsignal.config.response_headers
  • Typ: Array of Strings
  • Standardwert: ["content-length", "accept", "accept-charset", "accept-encoding", "accept-language", "cache-control", "connection", "range", "host"]
  • Erforderlich: Nein
Konfigurieren Sie, welche Response-Header einbezogen werden sollen, wenn eine Anfrage von einem HTTP-Client gestellt wird. Diese Option ist eine Zulassungsliste. Sie schließt nur die konfigurierten Header ein. Wenn die Liste leer ist, werden keine Header einbezogen. Die Response-Header werden aus den OpenTelemetry-Span-Attributen http.response.header.<key> gelesen, wobei <key> der normalisierte Header-Name (in Kleinbuchstaben) ist. Um keine Header zu setzen, setzen Sie den Wert des Ressourcenattributs explizit auf ein leeres Array.

Request-Header

  • Attributname: appsignal.config.request_headers
  • Typ: Array of Strings
  • Standardwert: ["content-length", "accept", "accept-charset", "accept-encoding", "accept-language", "cache-control", "connection", "range", "host"]
  • Erforderlich: Nein
Konfigurieren Sie, welche Request-Header einbezogen werden sollen, wenn eine Anfrage an einen HTTP-Server gestellt wird. Diese Option ist eine Zulassungsliste. Sie schließt nur die konfigurierten Header ein. Wenn die Liste leer ist, werden keine Header einbezogen. Die Request-Header werden aus den OpenTelemetry-Span-Attributen http.request.header.<key> gelesen, wobei <key> der normalisierte Header-Name (in Kleinbuchstaben) ist. Um keine Header zu setzen, setzen Sie den Wert des Ressourcenattributs explizit auf ein leeres Array.

Funktionsparameter senden

  • Attributname: appsignal.config.send_function_parameters
  • Typ: Boolean
  • Standardwert: true
  • Erforderlich: Nein
Konfigurieren Sie, ob Funktionsparameter in Traces einbezogen werden sollen. Wenn auf false gesetzt, werden keine solchen Daten an unsere Server gesendet. Diese Werte werden mit dem Span-Attribut appsignal.function.parameters gesetzt.

Request-Query-Parameter senden

  • Attributname: appsignal.config.send_request_query_parameters
  • Typ: Boolean
  • Standardwert: true
  • Erforderlich: Nein
Konfigurieren Sie, ob Request-Query-Parameter in Traces einbezogen werden sollen. Wenn auf false gesetzt, werden keine solchen Daten an unsere Server gesendet. Diese Werte werden mit dem Span-Attribut appsignal.request.query_parameters gesetzt. Weitere Informationen finden Sie unter Filterung von Request-Parametern.

Request-Payload senden

  • Attributname: appsignal.config.send_request_payload
  • Typ: Boolean
  • Standardwert: true
  • Erforderlich: Nein
Konfigurieren Sie, ob Request-Payload-Daten in Traces gesendet werden sollen. Wenn auf false gesetzt, werden keine solchen Daten an unsere Server gesendet. Diese Werte werden mit dem Span-Attribut appsignal.request.payload gesetzt.

Request-Session-Daten senden

  • Attributname: appsignal.config.send_request_session_data
  • Typ: Boolean
  • Standardwert: true
  • Erforderlich: Nein
Konfigurieren Sie, ob Request-Session-Daten in Traces gesendet werden sollen. Wenn auf false gesetzt, werden keine solchen Daten an unsere Server gesendet. Diese Werte werden mit dem Span-Attribut appsignal.request.session_data gesetzt.