Auf dieser Seite wird beschrieben, wie Sie den Code-Editor für PromQL verwenden. Der Editor ist in der Google Cloud Console verfügbar und bietet Vorschläge und andere Tools zum Erstellen gültiger PromQL-Abfragen.
Die PromQL-Sprache wird auf dieser Seite nicht behandelt. Informationen zu PromQL finden Sie in der Open-Source-Dokumentation. Die folgenden Ressourcen können Ihnen den Einstieg erleichtern:
Code-Editor aufrufen
Sie greifen über die folgenden Seiten der Google Cloud Console auf PromQL zu:
- Metrics Explorer
- Widget hinzufügen, wenn Sie Dashboards erstellen
So öffnen Sie den Code-Editor bei Verwendung des Metrics Explorer:
-
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 PromQL 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 Darstellung der Daten ändern. Weitere Informationen finden Sie auf den folgenden Seiten:
Code-Editor verwenden
Wenn Sie den Code-Editor verwenden möchten, geben Sie Ihre Abfrage in das Textfeld ein und 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 hat zwei Steuerelemente, die bestimmen, 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 während der Eingabe automatisch ausgeführt wird. Diese Option ist jedoch standardmäßig deaktiviert.
Verwenden Sie den Schalter Automatisch ausführen, um die Option „Automatisch ausführen“ zu 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.
Befindet sich der Cursor am Ende einer Abfrage, die unvollständig, aber fehlerfrei ist, wird im Editor ein gelbes Dreieck in der Steuerleiste angezeigt. Wenn Platz vorhanden ist, wird auch der Text Unvollständige Abfrage angezeigt.
Der Editor versucht nicht, unvollständige Abfragen auszuwerten.
Zwischen dem Code-Editor und dem Diagrammbereich befindet sich außerdem eine Ziehleiste. Mit dieser Leiste können Sie die relativen Größen der beiden Regionen ändern.
Diagramme speichern
Wie Sie ein Diagramm speichern, hängt davon ab, in welchem Kontext Sie es erstellt haben:
- Über den Metrics Explorer
- Beim Erstellen oder Bearbeiten eines benutzerdefinierten Dashboards
Diagramme aus dem Metrics Explorer speichern
Im Code-Editor im Metrics Explorer haben Sie die Möglichkeit, das Diagramm in einem benutzerdefinierten Dashboard zu speichern. 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 PromQL 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 „Automatisch ausführen“ für den Code-Editor nicht aktiviert ist, führen Sie Ihre Abfrage aus, indem Sie auf Abfrage ausführen klicken, bevor Sie das Diagramm speichern. Bei benutzerdefinierten Dashboards werden Ihre Änderungen standardmäßig regelmäßig gespeichert. Wenn Sie die Abfrage nicht zuerst ausführen, speichert der Code-Editor die letzte 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 „Automatisch ausführen“ für den Code-Editor nicht aktiviert ist, führen Sie Ihre Abfrage aus, indem Sie auf Abfrage ausführen klicken, bevor Sie das Diagramm speichern. Bei benutzerdefinierten Dashboards werden Ihre Änderungen standardmäßig regelmäßig gespeichert. Wenn Sie die Abfrage nicht zuerst ausführen, speichert der Code-Editor die letzte ausgeführte Abfrage.
Wenn die automatische Speicherung für Ihr Dashboard nicht aktiviert ist, klicken Sie auf Speichern.
Die Google Cloud Console unterstützt Filter auf Seitenebene für benutzerdefinierte Dashboards. Diese Filter werden für PromQL-Diagramme in Ihren benutzerdefinierten Dashboards unterstützt.
Code-Editor schließen
Wenn Sie den Code-Editor verlassen möchten, ohne die Abfrage zu speichern, klicken Sie auf einen der anderen Auswahl-Tabs. Jeglicher Abfragetext im Editor wird verworfen, Sie haben jedoch die Möglichkeit, ihn in der Zwischenablage zu speichern.