Trace-Datenexport – Übersicht

Beta

Dieses Produkt oder diese Funktion unterliegt den „Nutzungsbedingungen für Pre-GA-Angebote“ im Abschnitt „Allgemeine Nutzungsbedingungen“ der dienstspezifischen Nutzungsbedingungen. Pre-GA-Produkte und -Funktionen sind unverändert verfügbar und werden möglicherweise nur eingeschränkt unterstützt. Weitere Informationen finden Sie in den Beschreibungen der Startphase.

Diese Seite bietet eine konzeptionelle Übersicht über das Exportieren von Trace-Daten mit Cloud Trace. Trace-Daten können aus folgenden Gründen exportiert werden:

• Zum Speichern von Trace-Daten über einen längeren Aufbewahrungszeitraum als 30 Tage.

• Damit Sie Trace-Daten mit BigQuery-Tools analysieren können. Mit BigQuery können Sie beispielsweise Span-Zahlen und Quantile ermitteln. Informationen zu der Abfrage, die zum Generieren der folgenden Tabelle verwendet wird, finden Sie unter HipsterShop-Abfrage.

  

Funktionsweise von Exporten

Beim Exportieren wird eine Senke für ein Google Cloud-Projekt erstellt. Eine Senke definiert ein BigQuery-Dataset als Ziel.

Sie können eine Senke mit der Cloud Trace API oder der Google Cloud CLI erstellen.

Senken-Properties und Terminologie

Senken werden für ein Google Cloud-Projekt definiert und haben die folgenden Attribute:

• Name: Der Name der Senke. Ein Name könnte beispielsweise so aussehen:

  "projects/PROJECT_NUMBER/traceSinks/my-sink"
  

  Dabei ist PROJECT_NUMBER die Google Cloud-Projektnummer der Senke und my-sink die Senken-ID.

• Übergeordnet: Die Ressource, in der Sie die Senke erstellen. Das übergeordnete Element muss ein Google Cloud-Projekt sein:

  "projects/PROJECT_ID"
  

  Die PROJECT_ID kann entweder eine Google Cloud-Projekt-ID oder eine Google Cloud-Projektnummer sein.

• Ziel: Ein einzelner Ort, an den Trace-Spans gesendet werden. Trace unterstützt den Export von Traces nach BigQuery. Das Ziel kann das Google Cloud-Projekt der Senke oder ein anderes Google Cloud-Projekt in derselben Organisation sein.

  Ein gültiges Ziel ist beispielsweise:

  bigquery.googleapis.com/projects/DESTINATION_PROJECT_NUMBER/datasets/DATASET_ID
  

  Dabei ist DESTINATION_PROJECT_NUMBER die Google Cloud-Projektnummer des Ziels und DATASET_ID die BigQuery-Dataset-ID.

• Identität des Autors: Der Name des Dienstkontos. Der Inhaber des Exportziels muss diesem Dienstkonto Berechtigungen zum Schreiben in das Exportziel erteilen. Traces wendet diese Identität beim Exportieren von Traces für die Autorisierung an. Neue Senken erhalten zur Erhöhung der Sicherheit ein eindeutiges Dienstkonto:

  [e-mail]
  

  Dabei ist PROJECT_NUMBER Ihre Google Cloud-Projektnummer in Hex und GENERATED_VALUE ein zufällig generierter Wert.

  Sie erstellen, besitzen oder verwalten das Dienstkonto, das durch die Identität des Schreibers einer Senke identifiziert wird, nicht. Wenn Sie eine Senke erstellen, wird von Trace das erforderliche Dienstkonto erstellt. Dieses Dienstkonto ist nicht in der Liste der Dienstkonten für enthalten bis es mindestens eine Identity and Access Management-Bindung hat. Sie fügen dies hinzu Bindung, wenn Sie ein Senkenziel konfigurieren.

  Informationen zur Verwendung der Identität des Autors finden Sie unter Zielberechtigungen.

Funktionsweise von Senken

Jedes Mal, wenn ein Trace-Span in einem Projekt ankommt, exportiert Trace eine Kopie des Spans.

Traces, die vor der Erstellung der Senke empfangen wurden, können nicht exportiert werden.

Zugriffsteuerung

Zum Erstellen oder Ändern einer Senke benötigen Sie eine der folgenden Rollen für die Identitäts- und Zugriffsverwaltung:

• Trace-Administrator
• Trace-Nutzer
• Projektinhaber
• Projektbearbeiter

Weitere Informationen finden Sie unter Zugriffssteuerung.

Für den Export von Traces an ein Ziel benötigt das Dienstkonto des Senkenautors Schreibzugriff auf das Ziel. Weitere Informationen zu Identitäten von Autoren finden Sie auf dieser Seite unter Senkeneigenschaften.

Kontingente und Limits

Cloud Trace verwendet die BigQuery Streaming API, um Trace-Spans an das Ziel zu senden. Cloud Trace fasst API-Aufrufe in Batches zusammen. Cloud Trace implementiert keinen Wiederholungs- oder Drosselungsmechanismus. Trace-Spans werden möglicherweise nicht erfolgreich exportiert, wenn die Datenmenge die Zielkontingente überschreitet.

Weitere Informationen zu BigQuery-Kontingenten und -Limits finden Sie unter Kontingente und Limits.

Preise

Für den Export von Traces fallen keine Cloud Trace-Kosten an. Es können jedoch Kosten für BigQuery anfallen. Weitere Informationen finden Sie unter BigQuery-Preise.

Ihre Kosten schätzen

In BigQuery fallen Gebühren für die Datenaufnahme und -speicherung an. So schätzen Sie Ihre monatlichen BigQuery-Kosten:

1. Schätzen Sie die Gesamtzahl der Trace-Spans, die in einem Monat aufgenommen werden.

   Informationen zum Aufrufen der Nutzung finden Sie unter Nutzung nach Rechnungskonto ansehen.

2. Schätzen Sie die Streaminganforderungen basierend auf der Anzahl der aufgenommenen Trace-Spans.

   Jeder Span wird in eine Tabellenzeile geschrieben. Jede Zeile in BigQuery benötigt mindestens 1024 Byte. Eine Untergrenze für Ihre BigQuery-Streaminganforderungen besteht daher darin, jedem Span 1024 Byte zuzuweisen. Wenn Ihr Google Cloud-Projekt beispielsweise 200 Spans aufgenommen hat, benötigen diese Spans für die Streaming-Insert-Anweisung mindestens 20.400 Byte.

3. Mit dem Preisrechner können Sie Ihre BigQuery-Kosten aufgrund von Speicher, Streaming-Insert-Anweisungen und Abfragen schätzen.

BigQuery-Nutzung ansehen und verwalten

Die BigQuery-Nutzung können Sie mit dem Metrics Explorer einsehen. Sie können auch eine Benachrichtigungsrichtlinie erstellen, die Sie benachrichtigt, wenn Ihre BigQuery-Nutzung vordefinierte Limits überschreitet. Die folgende Tabelle enthält die Einstellungen zum Erstellen einer Benachrichtigungsrichtlinie. Sie können die Einstellungen in der Tabelle des Zielbereichs verwenden, wenn Sie ein Diagramm erstellen oder Metrics Explorer verwenden.

So erstellen Sie eine Benachrichtigungsrichtlinie, die ausgelöst wird, wenn die BigQuery-Messwerte überschreiten einen benutzerdefinierten Wert haben, verwenden Sie die folgenden Einstellungen.

Schritte zum Erstellen einer Benachrichtigungsrichtlinie

So erstellen Sie eine Benachrichtigungsrichtlinie:

1. Rufen Sie in der Google Cloud Console die Seite  Benachrichtigungen auf:

   Zu Benachrichtigungen

   Wenn Sie diese Seite über die Suchleiste suchen, wählen Sie das Ergebnis aus, dessen Zwischenüberschrift Monitoring ist.

2. Wenn Sie keine Benachrichtigungskanäle erstellt haben und Benachrichtigungen erhalten möchten, klicken Sie auf Benachrichtigungskanäle bearbeiten und fügen Sie Benachrichtigungskanäle hinzu. Kehren Sie nach dem Hinzufügen der Kanäle zur Seite Benachrichtigungen zurück.
3. Klicken Sie auf der Seite Benachrichtigungen auf Richtlinie erstellen.
4. Wenn Sie die Ressource, den Messwert und die Filter auswählen möchten, erweitern Sie das Menü Messwert auswählen und verwenden Sie die Werte in der Tabelle Neue Bedingung:
   1. Optional: Geben Sie den Ressourcen- oder Messwertnamen in die Filterleiste ein, um das Menü auf relevante Einträge zu beschränken.
   2. Wählen Sie einen Ressourcentyp aus. Wählen Sie beispielsweise VM-Instanz aus.
   3. Wählen Sie eine Messwertkategorie aus. Wählen Sie beispielsweise Instanz aus.
   4. Wählen Sie einen Messwert aus. Wählen Sie beispielsweise CPU-Auslastung aus.
   5. Klicken Sie auf Apply (Anwenden).
5. Klicken Sie auf Weiter und konfigurieren Sie den Benachrichtigungsrichtlinien-Trigger. Verwenden Sie zum Ausfüllen dieser Felder die Werte in der Tabelle Benachrichtigungstrigger konfigurieren.
6. Klicken Sie auf Weiter.

7. Optional: Klicken Sie auf Benachrichtigungskanäle, um Benachrichtigungen zu Ihrer Benachrichtigungsrichtlinie hinzuzufügen. Wählen Sie im Dialogfeld einen oder mehrere Benachrichtigungskanäle aus dem Menü aus und klicken Sie dann auf OK.

   Optional: Wenn Sie benachrichtigt werden möchten, wenn Vorfälle geöffnet und geschlossen werden, klicken Sie auf das Kästchen Bei Schließen von Vorfall benachrichtigen. Standardmäßig werden Benachrichtigungen nur gesendet, wenn Vorfälle geöffnet werden.

8. Optional: Aktualisieren Sie die Dauer bis zur automatischen Schließung von Vorfällen. Dieses Feld bestimmt, wann Monitoring Vorfälle ohne Messwertdaten schließt.
9. Optional: Klicken Sie auf Dokumentation und geben Sie alle Informationen ein, die in einer Benachrichtigung angezeigt werden sollen.
10. Klicken Sie auf Name der Benachrichtigung und geben Sie einen Namen für die Benachrichtigungsrichtlinie ein.
11. Klicken Sie auf Richtlinie erstellen.

Neue Bedingung Feld	Wert
Ressource und Messwert	Wählen Sie im Menü Ressourcen die Option BigQuery-Dataset aus. Wählen Sie im Menü Messwertkategorien die Option Speicher aus. Wählen Sie im Menü Messwerte einen Messwert aus. Zu den spezifischen Messwerten zählen Stored bytes, Uploaded bytes und Uploaded bytes billed. Eine vollständige Liste der verfügbaren Messwerte finden Sie unter BigQuery-Messwerte.
Filter	project-id: Ihre Google Cloud-Projekt-ID. dataset-id: Ihre Dataset-ID.
Über Zeitreihen Zeitreihen gruppieren nach	dataset-id: Ihre Dataset-ID.
Über Zeitreihen hinweg Zeitreihenaggregation	sum
Rollierendes Zeitfenster	1 m
Funktion für rollierendes Zeitfenster	mean

Benachrichtigungstrigger konfigurieren Feld	Wert
Bedingungstyp	Threshold
Benachrichtigungstrigger	Any time series violates
Grenzwertposition	Above threshold
Grenzwert	Sie legen den akzeptablen Wert fest.
Zeitfenster noch einmal testen	1 minute

Nächste Schritte

Informationen zum Konfigurieren einer Senke finden Sie unter Traces exportieren.