# Fiche connecteur Datadog
Catalogue Pipedream : connexion du compte et droits nécessaires. Les actions réellement utilisables sont vérifiées dans Bruno lors de la connexion. Les déclencheurs sont documentés à titre de référence et ne sont pas activés automatiquement dans Bruno.
Les noms et données des exemples sont fictifs ; toute exécution reste soumise aux droits et aux validations du connecteur.

## Datadog
URL : https://get-bruno.com/features/connectors/datadog
Référence texte : https://get-bruno.com/features/connectors/datadog/reference.txt
Origine : Catalogue Pipedream
Statut : Catalogue Pipedream — connexion à vérifier
Catégories : Outils de développement
Description : Datadog regroupe des outils pour consulter les régions du compte, les métriques, les journaux, les événements, les incidents, les moniteurs, les services, les hôtes et les tableaux de bord. Les outils de métriques s’appuient sur une phase de découverte des noms disponibles avant l’interrogation.
Authentification : API key
Présentation : Datadog regroupe des outils pour consulter les régions du compte, les métriques, les journaux, les événements, les incidents, les moniteurs, les services, les hôtes et les tableaux de bord. Les outils de métriques s’appuient sur une phase de découverte des noms disponibles avant l’interrogation.
Usage : Vérifier la région du compte avant d’interroger Datadog
Exemple de demande : Je veux savoir quelle région Datadog est associée au compte avant de chercher les journaux du service web-app.
Résultat attendu : La région du compte est renvoyée pour préparer les requêtes suivantes au bon endpoint.
À préciser : Compte Datadog connecté ; Région du compte si elle n’est pas déjà connue
Nature : Exemple sous réserve de connexion et de droits
Sources de l’exemple : https://pipedream.com/apps/datadog/actions/get-account-info ; https://pipedream.com/apps/datadog/actions/get-account-region
Usage : Chercher des journaux d’erreur pour un service
Exemple de demande : Je veux retrouver les logs en erreur de web-app sur la dernière heure pour le dossier Atelier Martin.
Résultat attendu : Une liste de journaux correspondant au filtre demandé est renvoyée.
À préciser : Nom du service, par exemple web-app ; Plage temporelle, par exemple la dernière heure ; Région du compte si elle n’est pas déjà connue
Nature : Exemple sous réserve de connexion et de droits
Sources de l’exemple : https://pipedream.com/apps/datadog/actions/search-logs ; https://pipedream.com/apps/datadog/actions/get-account-info
Usage : Suivre un moniteur et remonter les événements associés
Exemple de demande : Je veux trouver le moniteur en alerte sur le service web-app puis afficher les événements liés à cette alerte.
Résultat attendu : Le moniteur correspondant est renvoyé avec son état, puis les événements de la période utile sont consultés.
À préciser : Nom ou tag du moniteur ; Contexte du service concerné ; Plage horaire de l’alerte ; Région du compte si elle n’est pas déjà connue
Nature : Exemple sous réserve de connexion et de droits
Sources de l’exemple : https://pipedream.com/apps/datadog/actions/search-monitors ; https://pipedream.com/apps/datadog/actions/search-events
Limites propres au service : La région du compte doit être déterminée avant les autres outils Datadog si elle n’est pas déjà connue. La recherche de métriques commence par la découverte des noms de métriques disponibles. La recherche d’hôtes retourne au maximum 1 000 résultats. Le déclencheur « New Monitor Event (Instant) » est un trigger documentaire du catalogue, distinct des actions.
Vocabulaire français : Obtenir les informations du compte — Détecte la région Datadog du compte connecté; à appeler en premier si la région n’est pas connue. (https://pipedream.com/apps/datadog/actions/get-account-info)
Vocabulaire français : Obtenir la région du compte — Détecte la région du compte en validant la clé API contre les endpoints régionaux. (https://pipedream.com/apps/datadog/actions/get-account-region)
Vocabulaire français : Obtenir des données de métriques — Interroge des séries temporelles de métriques pour analyser des tendances et des performances système. (https://pipedream.com/apps/datadog/actions/get-metric-data)
Vocabulaire français : Lister les journaux — Retourne une liste de journaux correspondant à une requête de filtre, avec un endpoint GET à limite plus élevée. (https://pipedream.com/apps/datadog/actions/list-logs)
Vocabulaire français : Publier des données de métriques — Ajoute des points de métriques temporelles personnalisées dans Datadog; les données sont écrites dans la série de métriques. (https://pipedream.com/apps/datadog/actions/post-metric-data)
Vocabulaire français : Rechercher des tableaux de bord — Liste et recherche des tableaux de bord Datadog, avec identifiants, titres, URL et métadonnées. (https://pipedream.com/apps/datadog/actions/search-dashboards)
Vocabulaire français : Rechercher des événements — Recherche des événements Datadog, notamment les changements d’état de moniteur, déploiements, pics d’erreurs et événements d’infrastructure. (https://pipedream.com/apps/datadog/actions/search-events)
Vocabulaire français : Rechercher des hôtes — Recherche des hôtes d’infrastructure surveillés en filtrant par tag, nom ou correspondance partielle. (https://pipedream.com/apps/datadog/actions/search-hosts)
Vocabulaire français : Rechercher des incidents — Recherche des incidents Datadog selon l’état, la gravité et des métadonnées. (https://pipedream.com/apps/datadog/actions/search-incidents)
Vocabulaire français : Rechercher des journaux — Recherche des journaux Datadog à l’aide de facettes, de plages temporelles et d’une syntaxe de requête. (https://pipedream.com/apps/datadog/actions/search-logs)
Vocabulaire français : Rechercher des métriques — Outil de découverte qui liste les noms de métriques Datadog disponibles, éventuellement filtrés par hôte. (https://pipedream.com/apps/datadog/actions/search-metrics)
Vocabulaire français : Rechercher des moniteurs — Recherche des règles d’alerte Datadog avec état, seuils, conditions et tags. (https://pipedream.com/apps/datadog/actions/search-monitors)
Vocabulaire français : Rechercher des services — Liste les services du catalogue de services Datadog avec ownership, métadonnées et équipe. (https://pipedream.com/apps/datadog/actions/search-services)
Vocabulaire français : Nouvel événement de moniteur — Déclenche les nouveaux événements capturés par un moniteur Datadog. (https://pipedream.com/apps/datadog/triggers/new-monitor-event)
- action : Get Account Info — Detect the Datadog region for the connected account. Call this FIRST before any other Datadog tool if you do not already know the region. Returns the region domain (e.g. datadoghq.com ) which must be passed as the region parameter to Search Logs , Search Monitors , Get Metric Data , and all other Datadog tools. See the docs (https://pipedream.com/apps/datadog/actions/get-account-info)
- action : Get Account Region — Detect the Datadog region for the connected account by validating the API key against each regional endpoint. Use this to discover the correct region before calling other Datadog actions. See the docs (https://pipedream.com/apps/datadog/actions/get-account-region)
- action : Get Metric Data — Query time-series metric data for analyzing trends and system performance. Query syntax: avg:system.cpu.user{*} , sum:requests.count{env:prod} by {host} , max:system.mem.used{service:web} . Both from and to are POSIX timestamps in seconds. Use Search Metrics first to discover available metric names. Use Search Hosts to find valid host tags for scoping. After finding anomalies, use Search Logs to investigate related entries. See the docs (https://pipedream.com/apps/datadog/actions/get-metric-data)
- action : List Logs — Get a list of logs matching a filter query. Uses the GET endpoint with a higher rate limit (3600/hr vs 300/hr). See the docs (https://pipedream.com/apps/datadog/actions/list-logs)
- action : Post Metric Data — Post custom time-series metric data points to Datadog. Data appears in dashboards, monitors, and can be queried via Get Metric Data . Points: JSON object where keys are Unix timestamps (seconds) and values are numeric, e.g. {"1640995200": 1.0} . Use Search Metrics to verify a metric name exists, or post to a new name to create it. This is a WRITE operation that creates or appends data to a metric time series. See the docs (https://pipedream.com/apps/datadog/actions/post-metric-data)
- action : Search Dashboards — List and search Datadog dashboards. Returns dashboard IDs, titles, URLs, and metadata. Dashboard URL: https://app.{region}/dashboard/{id} where region comes from Get Account Info . Use alongside Search Services to find dashboards related to a specific service. See the docs (https://pipedream.com/apps/datadog/actions/search-dashboards)
- action : Search Events — Search Datadog events: monitor state changes, deployment markers, error spikes, and infrastructure events. Filter by sources (e.g. nagios,docker ), tags (e.g. env:prod,service:web ), and priority ( normal or low ). Time range defaults to last 24h (POSIX timestamps in seconds). To investigate a monitor alert, use Search Monitors first, then search events for the relevant time range. Follow up with Search Logs for deeper investigation. See the docs (https://pipedream.com/apps/datadog/actions/search-events)
- action : Search Hosts — Search monitored infrastructure hosts. Filter by tag ( env:production ), name ( host:web-01 ), or partial match. Sort by cpu , iowait , load , status , or apps . Host names from results can scope queries in Get Metric Data (e.g. avg:system.cpu.user{host:web-01} ), filter logs in Search Logs ( host:web-01 ), or filter metrics in Search Metrics . Max 1000 results. See the docs (https://pipedream.com/apps/datadog/actions/search-hosts)
- action : Search Incidents — Search Datadog incidents by state, severity, and metadata. Query syntax: state:active , state:resolved , severity:SEV-1 . After finding an incident, investigate with: Search Logs for the incident time window, Get Metric Data for relevant metrics, Search Events for related monitor alerts, and Search Services for ownership info. See the docs (https://pipedream.com/apps/datadog/actions/search-incidents)
- action : Search Logs — Search Datadog logs matching a query with support for facets and time ranges. Uses log search syntax: service:web-app status:error , @http.status_code:>=400 , boolean operators (AND, OR, NOT), and wildcards. Set from to now-1h for recent logs. Use Search Metrics to discover metric names or Search Hosts to find host names for filtering. To investigate an incident, use Search Incidents first, then search logs for that time window and service. See the docs (https://pipedream.com/apps/datadog/actions/search-logs)
- action : Search Metrics — Discovery tool: list available Datadog metric names, optionally filtered by host. Returns metric name strings (e.g. system.cpu.user , aws.ec2.cpuutilization ) for use in Get Metric Data queries with the syntax aggregation:metric.name{tags} . Use Search Hosts to find valid host names for the host filter. See the docs (https://pipedream.com/apps/datadog/actions/search-metrics)
- action : Search Monitors — Search Datadog monitors (alerting rules) including status, thresholds, and conditions. Query syntax: tag:env:production , type:metric , status:Alert . Tags filter: comma-separated (e.g. env:prod,team:backend ). After finding a monitor, use Search Events to see recent state changes, or Get Metric Data to query the underlying metric it tracks. Returns monitor ID, name, type, query, status, and tags. See the docs (https://pipedream.com/apps/datadog/actions/search-monitors)
- action : Search Services — List services from Datadog's Service Catalog with ownership, metadata, and team info. Use to discover service names for filtering in Search Logs ( service:my-app ) or finding monitors via Search Monitors ( tag:service:my-app ). Returns service definitions including links, docs, and on-call. See the docs (https://pipedream.com/apps/datadog/actions/search-services)
- trigger : New Monitor Event (Instant) — Emit new events captured by a Datadog monitor (https://pipedream.com/apps/datadog/triggers/new-monitor-event)