Python-Beispiel für die Instrumentierung

In diesem Dokument wird beschrieben, wie Sie eine Python-Anwendung instrumentieren, um Trace- und Messwertdaten mit dem OpenTelemetry SDK und einem OpenTelemetry-Collector zu erfassen. Außerdem wird beschrieben, wie Sie strukturierte JSON-Logs in die Standardausgabe schreiben. Wenn Sie die Instrumentierung testen möchten, laden Sie die Beispielanwendung herunter und führen Sie sie aus. Diese Anwendung verwendet das Web-Framework Flask und generiert Log-, Messwert- und Trace-Daten.

Wenn Sie einen OpenTelemetry Collector verwenden, instrumentieren Sie Ihre Anwendung mit dem SDK und dem OTLP-In-Process-Exporter des SDKs. Diese Instrumentierung ist anbieterneutral. Sie stellen auch einen OpenTelemetry Collector bereit, der Telemetriedaten vom In-Process-Exporter empfängt und diese dann in Ihr Google Cloud -Projekt exportiert. Weitere Informationen zu Collectors finden Sie unter Von Google entwickelter OpenTelemetry Collector.

Wir empfehlen, einen OpenTelemetry-Collector zu verwenden, um Ihre Telemetriedaten zu exportieren, wenn Ihre Umgebung die Verwendung eines Collectors unterstützt. In einigen Umgebungen müssen Sie einen In-Process-Exporter verwenden, der Daten direkt an IhrGoogle Cloud -Projekt sendet. Weitere Informationen zur In-Process-Instrumentierung finden Sie unter Vom Trace-Exporter zum OTLP-Endpunkt migrieren.

Weitere Informationen zur Instrumentierung finden Sie in den folgenden Dokumenten:

Manuelle und Zero-Code-Instrumentierung

Für diese Sprache definiert OpenTelemetry die Zero-Code-Instrumentierung als das Erfassen von Telemetriedaten aus Bibliotheken und Frameworks, ohne Codeänderungen vorzunehmen. Sie müssen jedoch Module installieren und Umgebungsvariablen festlegen.

In diesem Dokument wird die Instrumentierung ohne Code nicht beschrieben. Weitere Informationen zu diesem Thema finden Sie unter Python-Instrumentierung ohne Code.

Allgemeine Informationen finden Sie unter OpenTelemetry-Instrumentierung für Python.

Hinweis

  1. Installieren Sie die Google Cloud CLI.

  2. Konfigurieren Sie die gcloud CLI für die Verwendung Ihrer föderierten Identität.

    Weitere Informationen finden Sie unter Mit Ihrer föderierten Identität in der gcloud CLI anmelden.

  3. Führen Sie den folgenden Befehl aus, um die gcloud CLI zu initialisieren: 

    gcloud init

  4. Erstellen Sie ein Google Cloud Projekt oder wählen Sie eines aus.

    Rollen, die zum Auswählen oder Erstellen eines Projekts erforderlich sind

    • Projekt auswählen: Für die Auswahl eines Projekts ist keine bestimmte IAM-Rolle erforderlich. Sie können jedes Projekt auswählen, für das Ihnen eine Rolle zugewiesen wurde.
    • Projekt erstellen: Zum Erstellen eines Projekts benötigen Sie die Rolle „Projektersteller“ (roles/resourcemanager.projectCreator), die die Berechtigung resourcemanager.projects.create enthält. Weitere Informationen zum Zuweisen von Rollen