Auf dieser Seite wird die Verwendung des Code-Editors für PromQL beschrieben. 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 in der Google Cloud Console auf PromQL zu:
- Metrics Explorer
- Widget hinzufügen, wenn Dashboards erstellt werden
So öffnen Sie den Codeeditor 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 finden, 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.
Code-Editor verwenden
Geben Sie die Abfrage in das Textfeld ein und klicken Sie auf Abfrage ausführen, um den Codeeditor zu verwenden.
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, über die Sie festlegen können, wie er mit der 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 die Abfrage automatisch während der Eingabe ausgeführt wird. Diese Option ist jedoch standardmäßig deaktiviert.
Verwenden Sie die Ein/Aus-Schaltfläche Automatisch ausführen, um die Option für die automatische Ausführung 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.
Wenn sich der Cursor am Ende einer Abfrage befindet, die unvollständig ist, aber keine Fehler aufweist, zeigt der Editor ein gelbes Dreieck in der Steuerleiste an. Wenn genug Platz ist, wird auch der Text Unvollständige Abfrage angezeigt.
Der Editor versucht nicht, unvollständige Abfragen auszuwerten.
Es gibt auch eine Ziehleiste 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:
- Aus dem 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, Ihr 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 finden, 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.
- Geben Sie die Abfrage im Editor ein.
Wenn die Option zum automatischen Ausführen für den Code-Editor nicht aktiviert ist, führen Sie die Abfrage aus, indem Sie auf Abfrage ausführen klicken, bevor Sie das Diagramm speichern. Standardmäßig werden Ihre Änderungen in benutzerdefinierten Dashboards regelmäßig gespeichert. Wenn Sie Ihre Abfrage nicht zuerst ausführen, 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 gewünschte 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 zum automatischen Ausführen für den Code-Editor nicht aktiviert ist, führen Sie die Abfrage aus, indem Sie auf Abfrage ausführen klicken, bevor Sie das Diagramm speichern. Standardmäßig werden Ihre Änderungen in benutzerdefinierten Dashboards regelmäßig gespeichert. Wenn Sie Ihre Abfrage nicht zuerst ausführen, speichert der Code-Editor die zuletzt ausgeführte Abfrage.
Wenn die automatische Speicherung für das 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 beenden
Wenn Sie den Code-Editor verlassen möchten, ohne die Abfrage zu speichern, klicken Sie 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.