Auf dieser Seite wird die Verwendung des Codeeditors für PromQL beschrieben. Der Herausgeber ist in der Google Cloud Console verfügbar, bietet Vorschläge und weitere Tools zum Erstellen gültiger PromQL-Abfragen.
PromQL wird auf dieser Seite nicht behandelt. finden Sie Informationen zu PromQL empfehlen wir, sich in der Open-Source-Dokumentation nachzusehen. Die folgenden Ressourcen für den Einstieg:
Auf den Code-Editor zugreifen
Sie können über die folgenden Seiten in der Google Cloud Console auf PromQL zugreifen:
- Metrics Explorer
- Beim Erstellen von Dashboards Widget hinzufügen
So öffnen Sie den Code-Editor, wenn Sie den Metrics Explorer verwenden:
-
Rufen Sie in der Google Cloud Console die Seite leaderboard Metrics Explorer auf:
Wenn Sie diese Seite über die Suchleiste suchen, wählen Sie das Ergebnis aus, dessen Zwischenüberschrift Monitoring ist.
- Klicken Sie in der Symbolleiste des Bereichs "Query Builder" auf die Schaltfläche code MQL oder code PromQL.
- Prüfen Sie, ob PromQL in der Ein-/Aus-Schaltfläche Sprache ausgewählt ist. Die Sprachschaltfläche befindet sich in derselben Symbolleiste, mit der Sie Ihre Abfrage formatieren können.
Nachdem Sie die Abfrage abgeschlossen haben, können Sie die Legende konfigurieren oder die werden die Daten angezeigt. Weitere Informationen finden Sie auf den folgenden Seiten:
Code-Editor verwenden
Um den Code-Editor zu verwenden, geben Sie Ihre Abfrage in das Textfeld ein Klicken Sie auf Abfrage ausführen.
Automatische Vervollständigung
Während Sie Ihre Abfrage eingeben, zeigt der Editor eine Liste mit syntaxaktisch gültigen Vervollständigungen an. Sie können das Menü zur automatischen Vervollständigung manuell aufrufen. Dazu drücken Sie Control+Space und schließen es mit Escape.
Verwenden Sie die Pfeiltasten, um durch die Liste der Optionen zu gehen.
Durch Drücken von Enter wird die ausgewählte Auswahl eingefügt.
Um das Präfix für alle verfügbaren Optionen einzufügen, drücken Sie Tab.
Suchen und ersetzen
Der Editor unterstützt die Funktion „Suchen und Ersetzen“. Drücken Sie Control+F (oder Command+F für Mac), um Begriffe in Ihrer Abfrage zu finden und zu ersetzen. Der folgende Screenshot zeigt die Funktion:
Editor-Steuerelemente
Der Editor verfügt über zwei Steuerelemente, die festlegen, wie er mit Ihrer Abfrage interagiert.
Standardmäßig wird Ihre Abfrage nur ausgeführt, wenn Sie auf Abfrage ausführen klicken. Sie können den Editor so einrichten, dass Ihre Abfrage automatisch ausgeführt wird als bei der Eingabe, aber diese Option ist standardmäßig deaktiviert.
Über die Ein/Aus-Schaltfläche Automatisch ausführen können Sie die Option „Automatisch ausführen“ aktivieren. Wenn diese Option aktiviert ist, funktioniert der Editor so:
- Die Schaltfläche Abfrage ausführen wird nicht angezeigt.
- Während der Eingabe werden ständig Fehlermeldungen angezeigt.
Wenn sich der Cursor am Ende einer Abfrage befindet, die unvollständig ist, aber angezeigt wird, zeigt der Editor ein gelbes Dreieck in der Steuerleiste an. Wenn es Raum ist, wird ebenfalls der Text Unvollständige Suchanfrage angezeigt.
Der Editor versucht nicht, unvollständige Abfragen zu bewerten.
Außerdem gibt es eine Leiste zwischen dem Code-Editor und dem Diagrammbereich. Mit dieser Leiste können Sie die relativen Größen der beiden Regionen ändern.
Diagramme speichern
Wie Sie ein Diagramm speichern, hängt vom Kontext ab, in dem Sie das Diagramm erstellt haben. Diagramm:
- Im Metrics Explorer.
- Beim Erstellen oder Bearbeiten eines benutzerdefinierten Dashboards
Diagramme aus Metrics Explorer speichern
Im Code-Editor im Metrics Explorer können Sie in ein benutzerdefiniertes Dashboard. So speichern Sie das Diagramm:
-
Rufen Sie in der Google Cloud Console die Seite leaderboard Metrics Explorer auf:
Wenn Sie diese Seite über die Suchleiste suchen, wählen Sie das Ergebnis aus, dessen Zwischenüberschrift Monitoring ist.
- Klicken Sie in der Symbolleiste des Bereichs "Query Builder" auf die Schaltfläche code MQL oder code PromQL.
- Prüfen Sie, ob PromQL in der Ein-/Aus-Schaltfläche Sprache ausgewählt ist. Die Sprachschaltfläche befindet sich in derselben Symbolleiste, mit der Sie Ihre Abfrage formatieren können.
- Abfrage im Editor eingeben.
Wenn die Option zur automatischen Ausführung für den Code-Editor nicht aktiviert ist, führen Sie den folgenden Befehl aus: indem Sie vor dem Speichern des Diagramms auf Abfrage ausführen klicken. Standardmäßig speichern benutzerdefinierte Dashboards Ihre Änderungen regelmäßig. Wenn Sie nicht Ihre Abfrage zuerst speichern, speichert der Code-Editor die zuletzt ausgeführte Abfrage.
Klicken Sie auf Diagramm speichern.
So speichern Sie das Diagramm weiter:
- Geben Sie dem Diagramm einen aussagekräftigen Titel.
- Wählen Sie das Dashboard für das neue Diagramm aus.
- Klicken Sie im Dialogfeld auf Speichern.
Diagramme in einem benutzerdefinierten Dashboard speichern
So speichern Sie ein neues Diagramm in Ihrem Dashboard:
Geben Sie dem Diagramm einen aussagekräftigen Titel.
Wenn die Option zur automatischen Ausführung für den Code-Editor nicht aktiviert ist, führen Sie den folgenden Befehl aus: indem Sie vor dem Speichern des Diagramms auf Abfrage ausführen klicken. Standardmäßig speichern benutzerdefinierte Dashboards Ihre Änderungen regelmäßig. Wenn Sie nicht Ihre Abfrage zuerst speichern, speichert der Code-Editor die zuletzt ausgeführte Abfrage.
Wenn Sie das automatische Speichern für Ihr Dashboard nicht aktiviert haben, Klicken Sie auf Speichern.
Die Google Cloud Console unterstützt Filter für benutzerdefinierte Dashboards. Diese Filter werden für PromQL unterstützt Ihren benutzerdefinierten Dashboards Diagramme erstellen.
Code-Editor beenden
Wenn Sie den Code-Editor beenden möchten, ohne Ihre Abfrage zu speichern, auf einen der anderen Tabs für die Auswahl. Jeglicher Abfragetext im Editor wird verworfen, Sie haben jedoch die Möglichkeit, ihn in der Zwischenablage zu speichern.