Événements avec un check custom d'Agent

Envoi

Utilisez la fonction event(<DICT_ÉVÉNEMENT>) pour envoyer un événement depuis un check custom d’Agent :

self.event(
            {
              "timestamp": <TIMESTAMP_EPOCH>,
              "event_type": "<NOM_ÉVÉNEMENT>",
              "msg_title": "<TITRE>",
              "msg_text": "<MESSAGE>",
              "aggregation_key": "<CLÉ_AGRÉGATION>",
              "alert_type": "<TYPE_ALERTE>",
              "source_type_name": "<TYPE_SOURCE>",
              "host": "<HOSTNAME>",
              "tags": ["<TAGS>"],
              "priority": "<PRIORITÉ>"
            }
)

Les types de données et de clés suivants sont disponibles dans le dictionnaire de l’événement :

Clé	Type	Obligatoire	Description
`timestamp`	Nombre entier	Oui	Le timestamp epoch de l’événement
`event_type`	Chaîne	Oui	Le nom de l’événement
`msg_title`	Chaîne	Oui	Le titre de l’événement
`msg_text`	Chaîne	Oui	Le corps de texte de l’événement
`aggregation_key`	Chaîne	Non	La clé à utiliser pour agréger les événements
`alert_type`	Chaîne	Non	`error`, `warning`, `success` ou `info` (valeur par défaut : `info`)
`source_type_name`	Chaîne	Non	Le nom du type de source
`host`	Chaîne	Non	Le hostname
`tags`	Liste de chaînes	Non	La liste de tags associés à cet événement
`priority`	Chaîne	Non	Indique la priorité de l’événement (`normal` ou `low`)

Exemple

Voici un exemple d’utilisation d’un check custom d’Agent permettant d’envoyer régulièrement un événement. Consultez la rubrique Écrire un check custom d’Agent pour en savoir plus.

Créez un nouveau répertoire event_example.d/ dans le dossier conf.d/ à la racine du répertoire de configuration de votre Agent.
Dans le dossier event_example.d/, créez un fichier de configuration intitulé event_example.yaml avec le contenu suivant :
```
instances: [{}]
```
Accédez au dossier checks.d/ dans le dossier parent de conf.d/.

Dans ce dossier, créez un fichier de check custom event_example.py avec le contenu suivant :

event_example.py

    from datadog_checks.base import AgentCheck

    __version__ = "1.0.0"

    class MyClass(AgentCheck):
        def check(self, instance):
            self.event(
                {
                    "timestamp": time.time(),
                    "event_type": "Error",
                    "msg_title": "Exemple d'événement",
                    "msg_text": "Voici un exemple d'événement provenant de Datadog.",
                    "alert_type": "error",
                }
            )
    

Redémarrez l’Agent.

Pour valider votre check, lancez la commande status de l’Agent et cherchez event_example dans la section Checks :

=========
Collector
=========

  Running Checks
  ==============

    (...)

    event_example (1.0.0)
    ---------------------
      Instance ID: event_example:d884b5186b651429 [OK]
      Total Runs: 2
      Metric Samples: Last Run: 0, Total: 0
      Events: Last Run: 1, Total: 2
      Service Checks: Last Run: 0, Total: 0
      Average Execution Time : 0s

    (...)

Il ne vous reste plus qu’à accéder à votre flux d’événements Datadog pour visualiser vos événements :

Pour aller plus loin

Documentation, liens et articles supplémentaires utiles:

Écrire un check custom d'AgentDOCUMENTATION