Sie können Prometheus Query Language (PromQL) verwenden, um alle von Cloud Monitoring gespeicherten Messwerte abzufragen, einschließlich Google Cloud-Systemmesswerte, Kubernetes-Messwerte, benutzerdefinierte Messwerte und logbasierte Messwerte.
Cloud Monitoring-Messwertnamen PromQL zuordnen
Cloud Monitoring-Messwertnamen umfassen zwei Komponenten: eine Domain (z. B. compute.googleapis.com/) und einen Pfad (z. B. instance/disk/max_read_ops_count). Da PromQL nur die Sonderzeichen : und _ unterstützt, müssen Sie zuerst Monitoring-Messwertnamen mit PromQL kompatibel machen. Wenden Sie die folgenden Regeln an, um Monitoring-Messwertnamen zu PromQL zuzuordnen:
- Ersetzen Sie den ersten
/durch:. - Ersetzen Sie alle anderen Sonderzeichen (einschließlich
.und anderer/-Zeichen) durch_.
In der folgenden Tabelle sind einige Messwertnamen und ihre PromQL-Entsprechungen aufgeführt:
| Cloud Monitoring-Messwertname | PromQL-Messwertname |
|---|---|
kubernetes.io/container/cpu/limit_cores |
kubernetes_io:container_cpu_limit_cores |
compute.googleapis.com/instance/cpu/utilization |
compute_googleapis_com:instance_cpu_utilization |
logging.googleapis.com/log_entry_count |
logging_googleapis_com:log_entry_count |
custom.googleapis.com/opencensus/opencensus.io/ |
custom_googleapis_com:opencensus_opencensus_io_ |
agent.googleapis.com/disk/io_time |
agent_googleapis_com:disk_io_time |
Cloud Monitoring-Verteilungsmesswerte können wie Prometheus-Histogramme abgefragt werden, wobei das Suffix _count, _sum oder _bucket an den Messwertnamen angehängt wird:
| Cloud Monitoring-Messwertname | PromQL-Messwertnamen |
|---|---|
networking.googleapis.com/vm_flow/rtt |
networking_googleapis_com:vm_flow_rtt_sumnetworking_googleapis_com:vm_flow_rtt_countnetworking_googleapis_com:vm_flow_rtt_bucket
|
Typ der überwachten Ressource angeben
Wenn ein Messwert nur einem einzelnen von Cloud Monitoring überwachten Ressourcentyp zugeordnet ist, funktioniert die PromQL-Abfrage, ohne manuell einen Ressourcentyp anzugeben. Einige Messwerte innerhalb von Cloud Monitoring, darunter einige Systemmesswerte und viele der von den logbasierten Messwerten generierte Messwerte, lassen sich jedoch mehr als einem Ressourcentyp zuordnen.
Sie können prüfen, welche überwachten Ressourcentypen einem Messwert zugeordnet sind. Gehen Sie dabei so vor:
- Informationen zu den von Google ausgewählten Messwerten finden Sie in den Listen der verfügbaren Messwerte, einschließlich der Google Cloud-Messwerte und Kubernetes-Messwerte. Jeder Eintrag in der Dokumentation enthält die zugehörigen überwachten Ressourcentypen in der ersten Spalte des jeweiligen Eintrags unter dem Typ. Wenn keine überwachten Ressourcentypen aufgeführt sind, kann der Messwert einem beliebigen Typ zugeordnet werden.
Im Metrics Explorer können Sie Folgendes tun:
- Geben Sie den Namen des Messwerts in das Feld Messwert auswählen ein und navigieren Sie dann durch die Menüs, um den Messwert auszuwählen. Im Ressourcenmenü werden gültige Ressourcentypen für diesen Messwert aufgeführt, z. B. „VM-Instanz“.
- Klicken Sie in der Symbolleiste des Bereichs "Query Builder" auf die Schaltfläche code MQL oder code PromQL.
Prüfen Sie, ob MQL im Schalter Sprache ausgewählt ist. Die Sprachschaltfläche befindet sich in derselben Symbolleiste, mit der Sie Ihre Abfrage formatieren können.
Die angezeigte Abfrage zeigt den Ressourcentyp. Besonders nützlich ist MQL für Messwerte, die mit vielen überwachten Ressourcentypen verknüpft werden können, z. B. logbasierte, benutzerdefinierte oder benutzerdefinierte Messwerte.
Wenn ein Messwert mit mehr als einem Ressourcentyp verknüpft ist, müssen Sie den Ressourcentyp in Ihrer PromQL-Abfrage angeben. Mit dem speziellen Label monitored_resource können Sie den Ressourcentyp auswählen.
Überwachte Ressourcentypen sind in den meisten Fällen ein kurzer String wie gce_instance. Gelegentlich werden sie jedoch als vollständige URIs wie monitoring.googleapis.com/MetricIngestionAttribution angezeigt. Korrekt formulierte PromQL-Abfragen können so aussehen:
logging_googleapis_com:byte_count{monitored_resource="k8s_container"}custom_googleapis_com:opencensus_opencensus_io_http_server_request_count_by_method{monitored_resource="global"}loadbalancing_googleapis_com:l3_external_egress_bytes_count{monitored_resource="loadbalancing.googleapis.com/ExternalNetworkLoadBalancerRule"}
Der Wert von "" für das Label monitored_resource ist besonders und bezieht sich auf den standardmäßigen prometheus_target-Ressourcentyp, der für Managed Service for Prometheus-Messwerte verwendet wird.
Wenn Sie das Label monitored_resource nicht verwenden, wenn es erforderlich ist, wird der folgende Fehler angezeigt:
metric is configured to be used with more than one monitored resource type;
series selector must specify a label matcher on monitored resource name
Metadatenlabels verwenden
Sie können in PromQL Metadatenlabels wie jedes andere Label verwenden, wobei wie bei Messwertnamen auch Metadatenlabels von PromQL kompatibel sein müssen. Die Syntax für den Verweis auf ein Metadatensystemlabel vom Typ version lautet metadata_system_version und die Syntax für Metadatennutzerlabel vom Typ version lautet metadata_user_version. Korrekt formulierte PromQL-Abfragen mit Metadatenlabels können so aussehen:
compute_googleapis_com:instance_cpu_utilization{monitored_resource="gce_instance",metadata_user_env="prod"}sum(compute_googleapis_com:instance_cpu_utilization) by (metadata_system_region)
Das einzige Sonderzeichen, das Sie in Metadatenlabelschlüsseln verwenden können, ist das Zeichen _. Eine Aggregation mit Metadatenlabels vom Typ MULTI_STRING oder KEY_VALUE wird nicht unterstützt.
Labelkonflikte lösen
In Cloud Monitoring können Labels entweder zum Messwert oder zur Ressource gehören.
Wenn ein Messwertlabel denselben Schlüsselnamen wie ein Ressourcenlabel hat, können Sie speziell auf das Messwertlabel verweisen, indem Sie dem Labelschlüsselnamen in Ihrer Abfrage das Präfix metric_ hinzufügen.
Angenommen, Sie haben ein Ressourcenlabel und ein Messwertlabel mit dem Namen pod_name im Messwert example.googleapis.com/user/widget_count.
Um nach dem Wert des Ressourcenlabels zu filtern, verwenden Sie
example_googleapis_com:user_widget_count{pod_name="RESOURCE_LABEL_VALUE"}Um nach dem Wert des Messwertlabels zu filtern, verwenden Sie
example_googleapis_com:user_widget_count{metric_pod_name="METRIC_LABEL_VALUE"}