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 |
---|---|
compute.googleapis.com/instance/cpu/utilization |
compute_googleapis_com:instance_cpu_utilization |
logging.googleapis.com/log_entry_count |
logging_googleapis_com:log_entry_count |
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_sum networking_googleapis_com:vm_flow_rtt_count networking_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, lassen sich jedoch mehr als einem Ressourcentyp zuordnen.Sie können prüfen, welche überwachten Ressourcentypen einem Messwert zugeordnet sind. Gehen Sie dazu so vor:Trusted Cloud by S3NS 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.
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"}
loadbalancing_googleapis_com:l3_external_egress_bytes_count{monitored_resource="loadbalancing.googleapis.com/ExternalNetworkLoadBalancerRule"}
Wenn Sie das Label monitored_resource
nicht verwenden, wenn es benötigt wird, erhalten Sie folgende Fehlermeldung:
metric is configured to be used with more than one monitored resource type;
series selector must specify a label matcher on monitored resource name
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"}