Slack

Slack

Crawler Crawler

Présentation

Associez Slack à Datadog pour permettre à votre équipe de collaborer en :

  • partageant des graphiques avec vos collègues via les canaux privés ou publics de votre équipe ;
  • recevant des alertes et des notifications de Datadog au sein de Slack.

Configuration

Installation

Si vous utilisez les États-Unis comme région dans l’application Datadog, installez l’application Slack Datadog dans votre espace de travail Slack :

  1. Accédez au carré de l’intégration Slack sous Integrations dans l’application Datadog. Cliquez sur le bouton Connect Slack Account en bas du carré.

  2. Vérifiez que votre compte Slack et votre compte Datadog sont associés. Remarque : vous aurez peut-être besoin de l’autorisation de l’administrateur de votre espace de travail Datadog pour effectuer cette modification, mais vous n’aurez à le faire qu’une seule fois.

Remarque : l'intégration avec la liste des applications Slack fonctionne uniquement si vous utilisez la région États-Unis dans l’application Datadog. Pour les autres régions, consultez la documentation relative au Webhook Slack.

Utilisation de l’application Slack

Une fois installée, l’application Slack peut être invitée sur n’importe quel canal :

/invite @Datadog

Ensuite, associez votre compte Datadog à votre compte Slack :

/datadog accounts

Vous avez également la possibilité d’intégrer des composants de Datadog dans Slack à l’aide d’une commande.

/datadog dashboard
/datadog slo

Vous pouvez également copier et coller n’importe quel widget à partir de Datadog vers Slack en appuyant sur CMD + C ou CTRL + C, ou en affichant le menu déroulant en haut d’un widget puis en sélectionnant « Copy ». Lorsque vous collez un widget, celui-ci apparaît en-dessous d’un lien une fois envoyé dans un canal.

Connexion de monitors

Vous pouvez désactiver le déclenchement de monitors dans Slack en un seul clic.

Vous pouvez modifier les monitors à envoyer à partir de l’application Slack de deux façons :

Mise à jour groupée : effectuez une mise à jour groupée de tous les monitors à envoyer à partir de l’application Slack et ajoutez les boutons de désactivation en cliquant sur le bouton « Upgrade », situé en haut de la configuration pour chacun de vos comptes Slack dans le carré d’intégration dans Datadog.

Méthode manuelle : si vous souhaitez tester cette fonctionnalité avant de la déployer à toutes vos équipes, ajoutez manuellement les canaux à la nouvelle configuration de compte de l’application dans la configuration de l’intégration Slack. Remarque : vous devrez peut-être supprimer les références en double vers un même canal.

Utilisation des incidents Datadog

Déclarez un nouvel incident à partir de l’application Slack avec :

/datadog incident 

Lorsqu’un nouvel incident est créé, un canal Slack correspondant #incident-(identifiant unique) est créé, et un message est envoyé au canal pour vous indiquer le nouveau canal d’incident à utiliser. Le sujet du canal change en fonction de l’incident.

Mettez à jour l’état d’un incident (p. ex. sa sévérité) avec :

/datadog incident update 

Utilisez le menu des actions sur un message (les trois points qui s’affichent lorsque vous passez le curseur sur un message envoyé dans le canal #incident tout à droite) pour ajouter le message à la chronologie des événements pour cet incident dans l’application.

Utilisez le Webhook Slack si vous utilisez une région hors États-Unis de l’application Datadog.

Installation

Pour installer l’intégration Slack, accédez à son carré d’intégration dans l’application Datadog.

Configuration

  1. Dans votre compte Slack, accédez à la page Applications et recherchez Datadog.
  2. Cliquez sur Ajouter à Slack –> Add Datadog Integration, puis copiez l'URL du webhook Slack.
  3. Accédez au carré d’intégration Datadog/Slack dans l’onglet de configuration.
  4. Cliquez sur Add Account.
  5. Ajoutez le nom de compte Slack de votre choix via l’option Slack Account Name.
  6. Collez l’URL du Webhook dans le champ Slack Account Hook.
  7. Cliquez sur Save.
  8. Ajoutez les canaux Slack à utiliser pour transmettre les informations :
  1. Si vous souhaitez être informé pour chaque nouveau commentaire sur un graphique, cochez la case Transfer all user comments pour chaque canal. Si vous ne cochez pas cette case, vous devrez utiliser la syntaxe @slack-<NOM_COMPTE>-<NOM_CANAL> pour que les commentaires soient publiés sur Slack. Vous devez utiliser @slack-<NOM_CANAL> si vous n’utilisez qu’un seul compte ou si vous souhaitez publier les commentaires sur le premier compte uniquement.

Vous pouvez également configurer l’envoi d’alertes vers Slack à partir de monitors et du flux d’événements.

Remarque : si vous utilisez l’application Datadog en dehors des États-Unis et souhaitez profiter de l'intégration avec la liste des applications Slack, contactez notre équipe d’assistance.

Mentions « @ » dans Slack depuis l’alerte d’un monitor

Après avoir configuré l’intégration Slack, saisissez @slack dans le message de votre notification pour afficher la liste des canaux auxquels vous pouvez envoyer votre notification :

Ajoutez < > de chaque côté de @nomutilisateur dans le modèle de message de vos monitors afin de prévenir l’utilisateur défini dans les notifications Slack. Exemple : @slack-CANAL_SLACK <@NOMUTILISATEUR>.

Remarque : si vous ne parvenez pas à ping une personne, utilisez son nom d'utilisateur Slack plutôt que son nom d’affichage. Vous le trouverez dans les paramètres de compte Slack, sous Nom d’utilisateur.

Ajoutez la mention @ici ou @canal en utilisant respectivement <!ici> ou <!canal>.

Pour les groupes d’utilisateurs, utilisez <!subteam^ID_GROUPE>. Pour trouver l'ID_GROUPE, interrogez l’endpoint API de Slack usergroups.list. Par exemple, pour un groupe d’utilisateurs avec l’ID 12345, utilisez la syntaxe suivante :

<!subteam^12345>

Remarque : les caractères spéciaux à la fin du nom d’un canal ne sont pas pris en charge pour les notifications « @ » de Slack. Par exemple, @----critical_alerts fonctionne, mais @--critical_alerts-- ne recevra aucune notification.

Utilisation des template variables de message pour créer des mentions « @ » dynamiques

Utilisez des template variables de message dans un message de monitor pour créer des mentions « @ » dynamiques.

Par exemple, si la variable affichée est configurée en tant que canal dans l’intégration Slack :

  • @slack-{{nom.propriétaire}} publie un message sur le canal du propriétaire pour ce monitor.

  • @slack-{{host.name}} publie un message dans le canal #host.name Slack.

Vous pouvez également créer une mention « @ » transmise directement à une adresse e-mail spécifique :

  • @team-{{nom.équipe}}@entreprise.com envoie directement un e-mail à la liste de diffusion de l’équipe.

Données collectées

Métriques

L’intégration Slack n’inclut aucune métrique.

Événements

L’intégration Slack n’inclut aucun événement.

Checks de service

L’intégration Slack n’inclut aucun check de service.

Dépannage

Besoin d’aide ? Contactez l’assistance Datadog.