Calcular métricas a partir de registros

Calcular métricas significa generar métricas nuevas basadas en registros o métricas preexistentes para la observabilidad de los datos. Para calcular métricas en GDC, debes configurar reglas de registro en un LoggingRule recurso personalizado. Las reglas de registro precalculan expresiones que se necesitan con frecuencia o que son computacionalmente costosas. Estas reglas guardan el resultado como un nuevo conjunto de series temporales. Consultar el resultado precalculado es más rápido que ejecutar la expresión original cada vez que sea necesario. Este cálculo previo es especialmente útil para los paneles de control y las alertas complejas, que deben consultar la misma expresión repetidamente cada vez que se actualizan o se evalúan.

Puedes configurar reglas de registro en el recurso personalizado LoggingRule para calcular métricas basadas en datos de registro del sistema. El recurso personalizado LoggingRule contiene reglas de registro que describen las condiciones para calcular nuevas métricas basadas en registros preexistentes.

Antes de empezar

Para obtener los permisos que necesitas para calcular métricas a partir de los registros, pide al administrador de gestión de identidades y accesos de tu proyecto que te conceda uno de los siguientes roles en el espacio de nombres de tu proyecto:

  • Creador de reglas de registro: crea recursos personalizados de LoggingRule. Solicita el rol Creador de reglas de Logging (loggingrule-creator).
  • Editor de reglas de registro: edita o modifica LoggingRule recursos personalizados. Solicita el rol Editor de reglas de Logging (loggingrule-editor).
  • Visor de reglas de registro: muestra los recursos personalizados de LoggingRule. Solicita el rol Visor de reglas de registro (loggingrule-viewer).

Crear reglas de grabación

Define un nombre de registro y una expresión válida que evalúe la regla. La expresión debe resolverse en un valor numérico para registrarlo como una nueva métrica. Despliega el recurso personalizado en el espacio de nombres de tu proyecto en el clúster de administrador de la organización para crear las reglas de registro de la plataforma Observabilidad.

Para obtener más información sobre las reglas de registro de Observabilidad, consulta https://grafana.com/docs/loki/latest/rules/.

Sigue estos pasos para crear reglas de registro y calcular métricas en el espacio de nombres de tu proyecto:

  1. Abre o crea el archivo YAML del CR con la plantilla CR LoggingRule para las reglas de registros.
  2. En el campo namespace del CR, introduce el espacio de nombres de tu proyecto.
  3. En el campo name, introduce el nombre de la configuración de la regla.
  4. Opcional: Puedes elegir el origen del registro en el campo source. Por ejemplo, introduzca un valor como operational o audit.
  5. En el campo interval, introduce el número de segundos que durará el intervalo de evaluación de la regla.
  6. Opcional: En el campo limit, introduce el número máximo de alertas. Introduce 0 para recibir alertas ilimitadas.

  7. En el campo recordRules, introduce la siguiente información para calcular las métricas:

    • En el campo record, introduce el nombre del registro. Este valor define la serie temporal en la que se va a escribir la regla de registro y debe ser un nombre de métrica válido.

    • En el campo expr, introduce una expresión LogQL para la regla de registro.

      Esta expresión debe resolverse en un valor numérico para registrarse como una nueva métrica.

    • Opcional: En el campo labels, defina las etiquetas que quiera añadir o sobrescribir como pares clave-valor.

  8. Guarda el archivo YAML del CR.

  9. Despliega el CR en el espacio de nombres del clúster de administrador de tu proyecto para crear las reglas de registro.

Reglas de registro de LoggingRule

Un recurso personalizado LoggingRule contiene reglas de registro que describen las condiciones para calcular nuevas métricas basadas en datos de registro del sistema preexistentes para la observabilidad.

En el siguiente archivo YAML se muestra una plantilla para el campo recordRules del CR LoggingRule.

# Configures either an alert or a target record for precomputation
apiVersion: logging.gdc.goog/v1alpha1
kind: LoggingRule
metadata:
  # Choose namespace that matches the project's namespace
  # Note: The alert or record will be produced in the same namespace
  namespace: PROJECT_NAMESPACE
  name: alerting-config
spec:
  # Choose which log source to base alerts on (Operational/Audit/Security Logs)
  # Optional, Default: Operational
  source: <string>

  # Rule evaluation interval
  interval: <duration>

  # Configure limit for number of alerts (0: no limit)
  # Optional, Default: 0 (no limit)
  limit: <int>

  # Configure record rules to generate new metrics based on pre-existing logs.
  # Record rules generate metrics based on logs.
  # Use record rules for complex alerts, which query the same expression repeatedly every time they are evaluated.
  recordRules:
    # Define which timeseries to write to (must be a valid metric name)
  - record: <string>

    # Define LogQL expression to evaluate for this rule
    # https://grafana.com/docs/loki/latest/rules/
    expr: <string>

    # Define labels to add or overwrite
    # Optional, Map of {key, value} pairs
    labels:
      <labelname>: <labelvalue>
...

Sustituye PROJECT_NAMESPACE por el espacio de nombres de tu proyecto.