Simple Log Service:Syntaxe d'interrogation et d'analyse des données de métriques

Exemples SQL. Pour plus d'informations, consultez les cas d'utilisation SQL.

• Interrogez et analysez toutes les données.

  *| SELECT * FROM "my_metric_store.prom" WHERE __name__ != '' 

• Pour la métrique http_request_count, interrogez les données dont la valeur de domaine du champ __labels__ est www.example.com et obtenez la somme des valeurs du champ __value__.

  *| SELECT sum(__value__) FROM "my_metric_store.prom" WHERE __name__='http_request_count' and element_at(__labels__, 'domain')='www.example.com' 

• Pour la métrique http_request_count, interrogez les données dont la valeur de domaine du champ __labels__ est www.example.com, agrégez les valeurs du champ __value__ par heure et obtenez la somme des valeurs.

  *| SELECT sum(__value__),date_trunc('hour', __time_nano__/1000000) as t
  FROM "my_metric_store.prom" 
  WHERE __name__='http_request_count' and element_at(__labels__, 'domain')='www.example.com'
  GROUP BY t
  ORDER BY t DESC

Détails de la syntaxe SQL :

• La syntaxe SQL pour les données de métriques correspond à celle des données de journaux (Syntaxe d'analyse). Lors de l'interrogation des données de métriques avec SQL, le nom de la table dans une clause FROM doit être au format {metrics_store_name}.prom. {metrics_store_name} spécifie le nom du Metricstore que vous avez créé.

  Remarque

  Entourez le nom de la table de guillemets doubles ("").

• Utilisez la fonction element_at() pour obtenir la valeur d'une clé à partir du champ __labels__. Exemple : element_at(__labels__, 'key').

• Pour plus d'informations sur les schémas de table, consultez la section Format d'encodage.

Chaque fonction PromQL renvoie une table, similaire à une fonction définie par l'utilisateur renvoyant une table (UDTF).

• Schéma de table renvoyé par promql_query(string) et promql_query_range(string, string) :

  Champ	Type de champ	Description
  metric	varchar	Le nom de la métrique. Peut être vide si la requête inclut une clause GROUP BY.
  labels	map<varchar, varchar>	Les libellés sous forme de map clé-valeur.
  time	bigint	L'heure.
  value	double	La valeur à un instant donné.

  Exemples de requêtes :

  • Fonction promql_query(string)

    Saisissez *| select promql_query('up') from metrics dans l'éditeur de requête et cliquez sur Search & Analyze. Le résultat de la requête est renvoyé dans un tableau comportant quatre colonnes : time, metric, labels et value, affichant les valeurs de la métrique up pour chaque instance.

  • Fonction promql_query_range(string, string)

    Exécutez l'instruction SQL select promql_query_range('up', '30s') from metrics pour interroger les données de plage de la métrique PromQL up avec un pas de 30s. Le résultat de la requête s'affiche dans un tableau présentant les données de séries temporelles.

• Schéma de table renvoyé par promql_labels(), promql_labels(string), promql_label_values(string) et promql_label_values(string, string) :

  Champ	Type de champ	Description
  label	varchar	Clé de libellé

  Exemples de requêtes :

  • Fonction promql_labels()

    *| select promql_labels() from metrics. Le résultat de la requête renvoie la colonne label, contenant cinq noms de libellés : code, instance, job, le et method.

  • Fonction promql_labels(string)

    Par exemple, exécutez la requête *| select promql_labels('up') from metrics pour interroger tous les noms de libellés de la métrique up. Le résultat inclut __name__, instance et job.

  • Fonction promql_label_values(string)

    Par exemple, exécutez la requête *| select promql_label_values('instance') from metrics. La colonne label du résultat de la requête renvoie trois adresses d'instance : demo.promlabs.com:10000, demo.promlabs.com:10001 et demo.promlabs.com:10002.

  • Fonction promql_label_values(string, string)

    Exemple de requête : *| select promql_label_values('up{demo!="a"}','instance') from metrics. Le résultat de la requête renvoie la colonne label avec trois lignes : demo.promlabs.com:10000, demo.promlabs.com:10001 et demo.promlabs.com:10002.

• Schéma de table renvoyé par promql_series(string) :

  Champ	Type de champ	Description
  series	map<varchar, varchar>	La série temporelle.

  Exemple de requête :

  Par exemple, exécutez la requête *| select promql_series('up') from metrics. La colonne series du résultat contient trois lignes correspondant à demo.promlabs.com:10001, demo.promlabs.com:10000 et demo.promlabs.com:10002. Chaque ligne est une map contenant les champs instance, __name__ (valeur : up) et job (valeur : demo).