Syntaxe de requête des logs

Cette page décrit notre syntaxe de requête la plus récente. Pour la syntaxe utilisant attributes, consultez notre ancienne syntaxe de requête.

Le système de filtrage des logs d’AppSignal vous permet de rechercher et de filtrer les logs de votre application à l’aide d’une syntaxe de requête intuitive. Que vous deviez trouver des messages d’erreur spécifiques, filtrer par niveau de gravité ou effectuer des recherches dans des attributs personnalisés, notre langage de requête vous permet de cibler facilement exactement ce que vous cherchez.

Démarrage rapide

Commencez avec ces requêtes simples :

timeout

Recherche « timeout » dans le champ message.

severity=error

Trouve tous les logs de niveau erreur.

severity=error hostname=production-web-1

Trouve les erreurs d’un serveur spécifique.

Champs disponibles

Vous pouvez interroger les champs suivants dans vos logs :

Champ	Description	Exemple
`severity`	Niveau de log (error, warning, info, debug, trace)	`severity=error`
`hostname`	Hôte de l’application	`hostname=production-1`
`group`	Espace de noms défini pour votre application	`group="background jobs"`
`message`	Contenu du message de log	`message:timeout`
Attributs personnalisés	Tout attribut personnalisé défini dans vos logs	`duration>10.1`

Si aucun champ n’est fourni, la requête effectuera une recherche dans le champ message.

Opérateurs de requête

Opérateurs de recherche

Opérateur	Syntaxe	Description	Exemple
`:`	`field:value`	Contient la valeur	`message:error`
`!:`	`field!:value`	Ne contient pas la valeur	`hostname!:test`
`=`	`field=value`	Correspondance exacte	`severity=error`
`!=`	`field!=value`	Différent de	`source!=mongodb`

Utilisez des guillemets pour les valeurs contenant des espaces : group:"background jobs"

Opérateurs de comparaison

Pour les valeurs numériques :

Opérateur	Syntaxe	Description	Exemple
`>`	`attribute>value`	Supérieur à	`duration>100`
`<`	`attribute<value`	Inférieur à	`user_id<1000`
`>=`	`attribute>=value`	Supérieur ou égal à	`duration>=100`
`<=`	`attribute<=value`	Inférieur ou égal à	`user_id<=1000`

Attributs imbriqués

Nous utiliserons la structure JSON d’exemple suivante :

{
  "message": "User logged in",
  "group": "admin",
  "hostname": "production-1",
  "user": {
    "id": 123,
    "name": "John Doe",
    "emails": ["john@example.com", "john@work.com"],
    "location.country": "US"
  }
}

Interrogez les attributs JSON imbriqués à l’aide de la notation par points :

user.id=123

Accède aux propriétés d’objets imbriqués.

user.emails.0=john@example.com

Interroge les éléments d’un tableau par index (à partir de zéro).

user.location\.country=US

Échappez les points qui font partie du nom de champ lui-même à l’aide d’un backslash.

Combiner des requêtes

Logique AND (par défaut)

Les requêtes séparées par des espaces sont combinées avec AND :

severity=error hostname=production-1

Trouve les erreurs de production-1.

Logique OR

Utilisez OR pour faire correspondre n’importe quelle condition :

severity=error OR severity=warning

Trouve les erreurs ou les avertissements.

Regroupement avec des parenthèses

Utilisez des parenthèses pour les requêtes complexes :

severity=error AND (hostname=web-1 OR hostname=web-2)

Trouve les erreurs provenant de web-1 ou de web-2.

Gestion des logs

Déclencheurs

⌘I

Configuration de l'application

Performance / traçage

Alerting

Détection d'anomalies

Erreurs

Surveillance de disponibilité

Surveillance des processus

Logs

Métriques & tableaux de bord

Surveillance des hôtes

Démarrage rapide

Champs disponibles

Opérateurs de requête

Opérateurs de recherche

Opérateurs de comparaison

Attributs imbriqués

Combiner des requêtes

Logique AND (par défaut)

Logique OR

Regroupement avec des parenthèses

​Démarrage rapide

​Champs disponibles

​Opérateurs de requête

​Opérateurs de recherche

​Opérateurs de comparaison

​Attributs imbriqués

​Combiner des requêtes

​Logique AND (par défaut)

​Logique OR

​Regroupement avec des parenthèses

Démarrage rapide

Champs disponibles

Opérateurs de requête

Opérateurs de recherche

Opérateurs de comparaison

Attributs imbriqués

Combiner des requêtes

Logique AND (par défaut)

Logique OR

Regroupement avec des parenthèses