Labels für logbasierte Messwerte konfigurieren

Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

In diesem Dokument werden Label für logbasierte Messwerte erläutert. Weiter wird beschrieben, wie Sie Label für logbasierte Messwerte erstellen und verwenden.

Wenn Sie mit Labels vertraut sind, können Sie direkt zum Abschnitt Label erstellen auf dieser Seite gehen.

Labels für logbasierte Messwerte

Durch die Verwendung von Labels können logbasierte Messwerte mehrere Zeitachsen – eine pro Kombination von Labelwerten – enthalten. Alle logbasierten Messwerte haben Standardlabel.

Sie können sowohl für Zähler- als auch für Verteilungsmesswerte zusätzliche, benutzerdefinierte Labels erstellen, indem Sie Extrahiererausdrücke angeben. Ein Extrahiererausdruck teilt Cloud Logging mit, wie der Wert des Labels aus Logeinträgen extrahiert werden soll. So können Sie den Wert des Labels angeben:

• Als gesamten Inhalt eines benannten Felds im LogEntry-Objekt
• Als Teil eines benannten Felds, das mit einem regulären Ausdruck übereinstimmt

Sie können Labels aus den integrierten Feldern von LogEntry, z. B. httpRequest.status, oder aus einem der Nutzlastfelder textPayload, jsonPayload oder protoPayload extrahieren.

Weitere Informationen zu regulären Ausdrücken finden Sie auf der Seite zur RE2-Syntax.

Geben Sie keine vertraulichen Informationen in den Ausdruck des Extractors ein und extrahieren Sie keine vertraulichen Daten in Labels. Diese werden als Dienstdaten behandelt.

Beschränkungen von benutzerdefinierten Labels

Für benutzerdefinierte Labels gelten folgende Beschränkungen:

• Sie können pro Messwert bis zu 10 benutzerdefinierte Labels erstellen.

• Nachdem Sie ein Label erstellt haben, können Sie es nicht mehr löschen.

  • Sie können den Extrahiererausdruck und die Beschreibung eines bereits erstellten Labels ändern.

  • Sie können den Namen oder Werttyp eines bereits erstellten Labels nicht ändern.

• Nur die ersten 1.024 Zeichen eines Labelwerts werden beibehalten.

• Jeder logbasierte Messwert ist auf etwa 30.000 aktive Zeitachsen beschränkt, die von der Anzahl der möglichen Werte für jedes Label, einschließlich der Standardlabels, abhängen.

  Wenn Ihre Logeinträge beispielsweise aus 100 Ressourcen (z. B. VM-Instanzen) stammen und Sie eine Bezeichnung mit 20 möglichen Werten definieren, können Sie für Ihren Messwert bis zu 2.000 Zeitachsen verwenden.

Wenn Sie zu viele Zeitachsen oder zu viele Datenpunkte haben, steigen Ihre Kosten und Ihre Aktivitäten könnten behindert werden. Weitere Informationen zu den Kosten logbasierter Messwerte finden Sie unter Cloud Monitoring-Preise: Kostenpflichtige Messwerte. Informationen zu den Limits für logbasierte Messwerte finden Sie unter Kontingente und Limits: Logbasierte Messwerte und Fehlerbehebung bei logbasierten Messwerten.

Standardlabels

Die meisten logbasierten Messwerte haben vordefinierte Label:

• Ressourcenlabel: Bei allen Messwerten wird ein überwachtes Ressourcenobjekt verwendet, um die Quelle von Zeitachsendaten zu identifizieren. Jeder Ressourcentyp enthält einen Typnamen und ein oder mehrere Label. Beispiele für Ressourcentypen sind VM-Instanzen, Cloud SQL-Datenbanken und Load Balancer.

  Die Ressource und ihre Labels werden in Cloud Monitoring von anderen Messwertlabels getrennt aufgelistet. Sie dienen jedoch alle dem Zweck, zusätzliche Zeitachsen im Messwert zu erstellen. Weitere Informationen finden Sie unter Messwerte, Zeitachsen und Ressourcen.

• log: Dieses Label enthält den LOG_ID-Anteil des Felds logName in den Logeinträgen.

• severity: Dieses Label enthält den Wert des Felds severity in Logeinträgen. Der Schweregrad wird standardmäßig nur in logbasierten Systemmesswerten bereitgestellt.

Labels mit dem Metrics Explorer aufrufen

So rufen Sie die Labels für eine Zeitreihe auf, die für einen logbasierten Messwert generiert wurde:

1. Google Cloud Rufen Sie in der Console die Seite Logbasierte Messwerte auf:

   Zu Logbasierte Messwerte

   Wenn Sie diese Seite über die Suchleiste suchen, wählen Sie das Ergebnis aus, dessen Zwischenüberschrift Logging ist.

2. Suchen Sie den Messwert, den Sie anzeigen lassen möchten, und wählen Sie im Dreipunkt-Menü more_vert Mehr die Option Im Metrics Explorer ansehen aus.

   Warten Sie, bis im Diagramm Daten angezeigt werden. Bei einem protokollbasierten Messwert kann das einige Minuten dauern.

3. Maximieren Sie das Feld Filter, um die verfügbaren Labels zu sehen. Möglicherweise werden Ressourcenlabels und Messwertlabels angezeigt. Die Liste der Labels ist spezifisch für den Ressourcentyp und den Messwerttyp. Beispiel:

   • Der Ressourcentyp gce_instance hat drei Ressourcenlabels: project_id, instance_id und zone.

   • Der Messwerttyp logging/log_entry_count hat zwei Messwertlabels: log und severity. Ihre benutzerdefinierten Labels werden ebenfalls in diesem Abschnitt angezeigt.

4. So prüfen Sie, ob mit einem benutzerdefinierten Label die richtigen Daten aus Ihren Protokolleinträgen extrahiert werden:

   1. Ändern Sie das Element Aggregation in Nicht aggregiert.

   2. Wählen Sie im Diagramm entweder Tabelle oder Beides aus.

   3. Wählen Sie in der Symbolleiste view_column Menü „Spaltenanzeige“ und dann die Labels aus. In diesem Menü werden alle Labels angezeigt, für die es Daten gibt.

      Wenn Sie ein von Ihnen erstelltes Label nicht sehen, prüfen Sie den Feldnamen und den Ausdruck für den Extraktor.

Label erstellen

Benutzerdefinierte Labels werden zusammen mit dem Messwert erstellt. Sowohl Zählermesswerte als auch Verteilungsmesswerte können Labels haben. Sie können logbasierten Systemmesswerten keine Label hinzufügen.

Wenn Sie ein Label erstellen möchten, geben Sie das Feld im Logeintrag an und definieren Sie dann einen Ausdruck, mit dem ein Wert aus dem angegebenen Feld extrahiert wird.

gcloud logging metrics create METRIC_NAME --config-from-file FILENAME

{
  ...
  metricDescriptor: {
      labels: [
        { key: LABEL_NAME, valueType: LABEL_TYPE,
          description: LABEL_DESCRIPTION },
        ...
      ]
  },
  labelExtractors: {
    LABEL_NAME: EXTRACTOR_EXPRESSION,
    ...
  },
}

{
  ...
  metricDescriptor: {
      labels: [
        { key: "label_name_a", valueType: STRING },
        { key: "label_name_b", valueType: INT64 },
      ]
  },
  labelExtractors: {
    "label_name_a":
      "REGEXP_EXTRACT(jsonPayload.field_a, \"before ([a-zA-Z ]+) after\")",
    "label_name_b": "EXTRACT(jsonPayload.field_b)",
  },
}

Beispiele

In diesem Abschnitt finden Sie einige Beispiele, die Ihnen den Einstieg in das Erstellen von Labels für benutzerdefinierte logbasierte Messwerte erleichtern sollen. Nachdem Sie ein Label erstellt haben, empfehlen wir Ihnen, die Labels mit dem Metrics Explorer zu überprüfen.

Tipps:

• Sie müssen eine Erfassungsgruppe verwenden, wenn Sie einen Ausdruck für den Extractor angeben.
• Wenn Sie keinen Ausdruck für den Extractor angeben, wird der gesamte Wert des Felds extrahiert.

• Die möglichen Werte für jedes Label müssen eingeschränkt sein. Ein kleiner Satz diskreter Werte (z. B. „Rot“, „Grün“ und „Blau“) wird bevorzugt. Wenn Sie beispielsweise die 8‑Bit-RGB-Werte für ein Farblabel extrahieren, können Sie über 16 Millionen verschiedene Werte haben. Das bedeutet, dass Sie über 16 Millionen Zeitreihen haben könnten.

  Extrahieren Sie keine hochauflösenden Werte wie Zeitstempel, eindeutige Kennungen, Nutzer-IDs, IP-Adressen, nicht parametrisierte URLs usw.

Statuscode aus einem Audit-Log extrahieren

Wenn ein Feld keine Sonderzeichen enthält, können Sie den Feldnamen im Label für den datenlogistischen Messwert verwenden.

Bei Audit-Logs entspricht das Feld protoPayload beispielsweise der Struktur AuditLog. Wenn Sie das Feld status aus einem Audit-Log extrahieren möchten, können Sie den Feldnamen auf protoPayload.status.code festlegen und den Ausdruck für den Extractor leer lassen.

Wenn Sie nur die erste Ziffer des Fehlercodes extrahieren möchten, können Sie den Ausdruck für den Extraktor auf (\d)\d\d festlegen.

Wert aus einem Feld mit Sonderzeichen extrahieren

Wenn ein Feld in einem Logeintrag Sonderzeichen enthält, setzen Sie es in doppelte Anführungszeichen.

Wenn Sie beispielsweise den gesamten Wert des Labels k8s-pod/k8s-app extrahieren möchten, legen Sie den Feldnamen auf labels."k8s-pod/k8s-app" fest und lassen Sie den Ausdruck leer.

Wert aus einer Textnutzlast extrahieren

Betrachten Sie einen Logeintrag im folgenden Format:

textPayload: "unfinished_task_instance_count.py:61 Unfinished task instance count metric value 0 for state: deferred"

Wenn Sie den Wert für den Status, z. B. deferred, aus Protokolleinträgen mit dem vorherigen Format extrahieren möchten, können Sie Folgendes tun:

• Feldname: textPayload
• Ausdruck für den Datenextraktor: ^unfinished.*state: ([a-z]+)

Wert aus einem wiederkehrenden Feld extrahieren

Ein Logeintrag kann ein Feld mit wiederholten Feldern enthalten. In JSON werden diese Felder in eckigen Klammern ([]) dargestellt. Betrachten Sie die wiederholten Felder aus der Perspektive von Labels als Satz und den Label-Extractor als Iterator. Sie geben die Kriterien für die Übereinstimmung an, wenn Sie das Label definieren. Der Extractor durchsucht dann die Gruppe, bis eine Übereinstimmung gefunden wird. Es wird immer die erste Übereinstimmung zurückgegeben, auch wenn mehrere Elemente des Satzes den Kriterien entsprechen.

Sie möchten einen logbasierten Messwert erstellen, mit dem Audit-Logs gezählt werden. Bevor Sie das Label konfigurieren, sehen Sie sich mehrere Prüfprotokolle an und stellen fest, dass das Format der protoPayload der Struktur AuditLog entspricht. Im Folgenden ist ein Teil eines Audit-Logeintrags dargestellt.

{
  ...
  protoPayload: {
    @type: "type.googleapis.com/google.cloud.audit.AuditLog"
    authenticationInfo: {1}
    authorizationInfo: [
      0: {
        granted: true
        permission: "io.k8s.coordination.v1.leases.get"
        resource: "coordination.k8s.io/v1/namespaces/kube-system/leases/maintenance-controller"
      }
    ]
    requestMetadata: {2}
    status: {1}
    ...
  }
  ...
}

Sie erstellen ein Label für Ihren logbasierten Messwert, in dem Informationen aus dem Feld permission gespeichert werden. Sie stellen fest, dass diese Felder wie io.k8s.xxx formatiert sind, wobei xxx ein String ist, der weitere Details zur Anfrage enthält. Dieser String kann einen Wert wie get oder eine komplexere Formatierung wie io.k8s.coordination.v1.leases.get haben.

Um die Anzahl der Labelwerte zu minimieren, sollten Sie die detaillierten Informationen nicht extrahieren. Sie möchten nur Werte wie get oder coordination im Label speichern. Außerdem möchten Sie das gängige Präfix io.k8s. nicht in den Labelwert aufnehmen.

Als Nächstes konfigurieren Sie das Label. Da das Feld permission ein wiederholtes Feld ist, dessen übergeordnetes Feld authorizationInfo ist, legen Sie den Feldnamen so fest:

protoPayload.authorizationInfo.permission

Als Nächstes erstellen Sie den folgenden regulären Ausdruck:

io.k8s.([a-z]+).*