Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Le calcul des métriques consiste à générer de nouvelles métriques basées sur des journaux ou des métriques préexistants pour l'observabilité des données. Dans GDC, vous calculez les métriques en configurant des règles d'enregistrement dans une ressource personnalisée LoggingRule. Les règles d'enregistrement précalculent les expressions fréquemment nécessaires ou coûteuses en termes de calcul. Ces règles enregistrent leur résultat sous la forme d'un nouvel ensemble de séries temporelles. Interroger le résultat précalculé est plus rapide que d'exécuter l'expression d'origine chaque fois que nécessaire. Cette précomputation est particulièrement utile pour les tableaux de bord et les alertes complexes, qui doivent interroger la même expression à plusieurs reprises chaque fois qu'ils sont actualisés ou évalués.
Vous configurez des règles d'enregistrement dans la ressource personnalisée LoggingRule pour calculer les métriques en fonction des données de journalisation du système. La ressource personnalisée LoggingRule contient des règles d'enregistrement qui décrivent les conditions à remplir pour calculer de nouvelles métriques à partir de journaux préexistants.
Avant de commencer
Pour obtenir les autorisations nécessaires pour calculer les métriques à partir des journaux, demandez à votre administrateur IAM de projet de vous accorder l'un des rôles suivants dans l'espace de noms de votre projet :
Créateur de règles de journalisation : crée des ressources personnalisées LoggingRule. Demandez le rôle Créateur de règles Logging (loggingrule-creator).
Éditeur de règles de journalisation : permet de modifier les ressources personnalisées LoggingRule. Demandez le rôle Éditeur de règles de journalisation (loggingrule-editor).
Lecteur de règles de journalisation : affiche les ressources personnalisées LoggingRule. Demandez le rôle Lecteur de règles de journalisation (loggingrule-viewer).
Créer des règles d'enregistrement
Définissez un nom d'enregistrement et une expression valide qui évalue la règle. L'expression doit se résoudre en une valeur numérique pour être enregistrée en tant que nouvelle métrique. Déployez la ressource personnalisée dans l'espace de noms de votre projet sur le cluster d'administrateur de l'organisation pour créer les règles d'enregistrement pour la plate-forme Observability.
Suivez les étapes ci-dessous pour créer des règles d'enregistrement et calculer des métriques dans l'espace de noms de votre projet :
Ouvrez ou créez le fichier YAML pour le CR à l'aide du modèle CR LoggingRule pour les règles d'enregistrement des journaux.
Dans le champ namespace du CR, saisissez l'espace de noms de votre projet.
Dans le champ name, saisissez le nom de la configuration de la règle.
Facultatif : Vous pouvez choisir la source du journal dans le champ source. Par exemple, saisissez une valeur telle que operational ou audit.
Dans le champ interval, saisissez le nombre de secondes correspondant à la durée de l'intervalle d'évaluation de la règle.
Facultatif : Dans le champ limit, saisissez le nombre maximal d'alertes. Saisissez 0 pour définir un nombre illimité d'alertes.
Dans le champ recordRules, saisissez les informations suivantes pour calculer les métriques :
Dans le champ record, saisissez le nom de l'enregistrement. Cette valeur définit la série temporelle dans laquelle écrire la règle d'enregistrement. Il doit s'agir d'un nom de métrique valide.
Dans le champ expr, saisissez une expression LogQL pour la règle de journal.
Cette expression doit correspondre à une valeur numérique pour être enregistrée en tant que métrique.
Facultatif : Dans le champ labels, définissez les libellés que vous souhaitez ajouter ou remplacer sous forme de paires clé/valeur.
Enregistrez le fichier YAML du CR.
Déployez le CR dans l'espace de noms de votre projet du cluster d'administrateur pour créer les règles d'enregistrement.
Règles d'enregistrement LoggingRule
Une ressource personnalisée LoggingRule contient des règles d'enregistrement qui décrivent les conditions permettant de calculer de nouvelles métriques basées sur des données de journalisation système préexistantes pour l'observabilité.
Le fichier YAML suivant montre un modèle pour le champ recordRules de la CR LoggingRule.
# Configures either an alert or a target record for precomputationapiVersion:logging.gdc.goog/v1alpha1kind:LoggingRulemetadata:# Choose namespace that matches the project's namespace# Note: The alert or record will be produced in the same namespacenamespace:PROJECT_NAMESPACEname:alerting-configspec:# Choose which log source to base alerts on (Operational/Audit/Security Logs)# Optional, Default: Operationalsource:<string>
# Rule evaluation intervalinterval:<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} pairslabels:<labelname>:<labelvalue>
...
Remplacez PROJECT_NAMESPACE par l'espace de noms de votre projet.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/09/04 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Difficile à comprendre","hardToUnderstand","thumb-down"],["Informations ou exemple de code incorrects","incorrectInformationOrSampleCode","thumb-down"],["Il n'y a pas l'information/les exemples dont j'ai besoin","missingTheInformationSamplesINeed","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2025/09/04 (UTC)."],[[["\u003cp\u003eMetrics can be calculated in GDC by configuring recording rules within a \u003ccode\u003eLoggingRule\u003c/code\u003e custom resource, precomputing frequently needed or complex expressions for faster querying.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eLoggingRule\u003c/code\u003e custom resource defines the conditions for creating new metrics derived from existing system logs, making it useful for dashboards and complex alerts.\u003c/p\u003e\n"],["\u003cp\u003eUsers require specific IAM roles such as Logging Rule Creator, Editor, or Viewer to interact with \u003ccode\u003eLoggingRule\u003c/code\u003e custom resources for calculating metrics.\u003c/p\u003e\n"],["\u003cp\u003eCreating a recording rule involves defining a record name and a LogQL expression that evaluates to a numeric value, and then deploying the custom resource within the project's namespace on the org admin cluster.\u003c/p\u003e\n"],["\u003cp\u003eWhen configuring a recording rule in the \u003ccode\u003eLoggingRule\u003c/code\u003e custom resource, you can specify the log source, evaluation interval, and limit for the number of alerts, along with the record name, expression, and optional labels.\u003c/p\u003e\n"]]],[],null,["# Calculate metrics from logs\n\nCalculating metrics means generating new metrics based on pre-existing logs or metrics for data observability. You calculate metrics in GDC by configuring recording rules in a `LoggingRule` custom resource. Recording rules precompute expressions that are frequently needed or computationally expensive. These rules save their result as a new set of time series. Querying the precomputed result is faster than executing the original expression whenever needed. This precomputation is especially useful for dashboards and complex alerts, which must query the same expression repeatedly every time they refresh or are evaluated.\n\nYou configure recording rules in the `LoggingRule` custom resource to calculate metrics based on system logging data. The `LoggingRule` custom resource contains recording rules that describe the conditions to calculate new metrics based on pre-existing logs.\n\nBefore you begin\n----------------\n\nTo get the permissions you need to calculate metrics from logs, ask your Project IAM Admin to grant you one of the following roles in your project namespace:\n\n- **Logging Rule Creator** : creates `LoggingRule` custom resources. Request the Logging Rule Creator (`loggingrule-creator`) role.\n- **Logging Rule Editor** : edits or modifies `LoggingRule` custom resources. Request the Logging Rule Editor (`loggingrule-editor`) role.\n- **Logging Rule Viewer** : views `LoggingRule` custom resources. Request the Logging Rule Viewer (`loggingrule-viewer`) role.\n\nCreate recording rules\n----------------------\n\nDefine a record name and a valid expression that evaluates the rule. The expression must resolve to a numeric value to record it as a new metric. Deploy the custom resource in your project namespace on the org admin cluster to create the recording rules for the Observability platform.\n| **Important:** To create rules, verify that a project is deployed with workloads. To have data your rules can act on, verify that you configured log collection.\n\nFor more information about recording rules for Observability, see \u003chttps://grafana.com/docs/loki/latest/rules/\u003e\n\nWork through the following steps to create record rules and calculate metrics in your project's namespace:\n\n1. Open or create the YAML file for the CR using [the `LoggingRule` CR](#loggingrule-recordrules) template for logging record rules.\n2. In the `namespace` field of the CR, enter your project's namespace.\n3. In the `name` field, enter the name for the rule configuration.\n4. Optional: You can choose the log source in the `source` field. For example, enter a value such as `operational` or `audit`.\n5. In the `interval` field, enter the number of seconds for the duration of the rule evaluation interval.\n6. Optional: In the `limit` field, enter the maximum number of alerts. Enter `0` for unlimited alerts.\n7. In the `recordRules` field, enter the following information to calculate metrics:\n\n - In the `record` field, enter the record name. This value defines the time series in which to write the record rule and it must be a valid metric name.\n - In the `expr` field, enter a LogQL expression for the log rule.\n\n This expression must resolve to a numeric value to be recorded as a new metric.\n - Optional: In the `labels` field, define the labels that you want to add or overwrite as key-value pairs.\n\n8. Save the YAML file of the CR.\n\n9. Deploy the CR in your project's namespace of the admin cluster to create the record rules.\n\nThe `LoggingRule` record rules\n------------------------------\n\nA `LoggingRule` custom resource contains recording rules that describe the conditions to calculate new metrics based on pre-existing system logging data for observability.\n\nThe following YAML file shows a template for the `recordRules` field of the `LoggingRule` CR. \n\n # Configures either an alert or a target record for precomputation\n apiVersion: logging.gdc.goog/v1alpha1\n kind: LoggingRule\n metadata:\n # Choose namespace that matches the project's namespace\n # Note: The alert or record will be produced in the same namespace\n namespace: \u003cvar translate=\"no\"\u003e\u003cspan class=\"devsite-syntax-l devsite-syntax-l-Scalar devsite-syntax-l-Scalar-Plain\"\u003ePROJECT_NAMESPACE\u003c/span\u003e\u003c/var\u003e\n name: alerting-config\n spec:\n # Choose which log source to base alerts on (Operational/Audit/Security Logs)\n # Optional, Default: Operational\n source: \u003cstring\u003e\n\n # Rule evaluation interval\n interval: \u003cduration\u003e\n\n # Configure limit for number of alerts (0: no limit)\n # Optional, Default: 0 (no limit)\n limit: \u003cint\u003e\n\n # Configure record rules to generate new metrics based on pre-existing logs.\n # Record rules generate metrics based on logs.\n # Use record rules for complex alerts, which query the same expression repeatedly every time they are evaluated.\n recordRules:\n # Define which timeseries to write to (must be a valid metric name)\n - record: \u003cstring\u003e\n\n # Define LogQL expression to evaluate for this rule\n # https://grafana.com/docs/loki/latest/rules/\n expr: \u003cstring\u003e\n\n # Define labels to add or overwrite\n # Optional, Map of {key, value} pairs\n labels:\n \u003clabelname\u003e: \u003clabelvalue\u003e\n ...\n\nReplace \u003cvar translate=\"no\"\u003ePROJECT_NAMESPACE\u003c/var\u003e with the namespace of your project."]]
