Connecter Slack

Envoyez les alertes InfraNest directement dans un canal Slack, pour que toute votre équipe voie les incidents, expirations et changements de statut là où elle travaille déjà.

#Aperçu

• Les alertes sont publiées dans le canal Slack de votre choix, et se mettent à jour automatiquement quand un problème est résolu — la résolution apparaît comme une réponse dans le même fil.
• Vous et votre équipe pouvez agir sur une alerte directement depuis Slack : l'acquitter, la mettre en silence, publier une mise à jour de statut, ou créer un ticket dans votre outil de suivi.
• Vous pouvez aussi recevoir vos propres alertes en messages privés Slack, indépendamment de ce que le canal partagé reçoit.

#Connectez-la dans InfraNest

1. Allez dans Intégrations → Slack et sélectionnez Connecter.
2. Slack vous demande d'ajouter InfraNest à votre espace de travail. Vérifiez l'espace de travail affiché en haut à droite, puis sélectionnez Allow.
3. De retour dans InfraNest, choisissez le canal vers lequel les alertes doivent être envoyées. Vous pourrez ajouter d'autres canaux au même espace de travail plus tard avec Add channel.
4. Sélectionnez Envoyer un test à côté de la nouvelle destination pour vérifier qu'une alerte arrive bien dans le canal attendu.

Après avoir autorisé l'accès, InfraNest vous envoie un message de bienvenue dans Slack. Vous êtes immédiatement lié à votre compte InfraNest, et vous pouvez choisir le premier canal et envoyer une alerte de test depuis ce message sans revenir ici. Quand un canal commence à recevoir des alertes, InfraNest s'y présente une fois, pour que votre équipe comprenne ce que sont les messages et les boutons.

TipVous pouvez aussi taper /invite @InfraNest dans n'importe quel canal Slack à la place. InfraNest vous demandera alors en privé si vous souhaitez y envoyer vos alertes.

Un canal privé n'apparaît dans la liste des canaux d'InfraNest qu'une fois que vous y avez invité @InfraNest dans Slack (tapez /invite @InfraNest dans le canal). Les canaux publics fonctionnent sans invitation.

#Agir sur une alerte depuis Slack

Les alertes publiées via l'application InfraNest comportent des boutons : Acknowledge tant que personne ne s'en occupe, Silence 1 h tant que le problème est ouvert, et Open in InfraNest. Quand quelqu'un appuie sur l'un d'eux, l'alerte se met à jour pour tout le monde dans le canal, par exemple Acknowledged by Sam at 02:16.

Une fois que quelqu'un s'en occupe, l'alerte propose aussi Add a note et, quand le moniteur figure sur l'une de vos pages de statut, Post a status update :

• Add a note enregistre une note sur l'incident pour votre équipe. Elle est publiée dans le fil de l'alerte et n'est jamais publique.
• Post a status update vous permet de choisir le statut (Investigating, Identified, Monitoring ou Resolved), de rédiger le message, et de choisir si les abonnés sont informés. Vous voyez toujours une étape de relecture d'abord, car la mise à jour est publique : elle apparaît immédiatement sur votre page de statut, puis est annoncée dans le fil de l'alerte.

Les boutons agissent en votre nom, avec le rôle que vous avez dans InfraNest. La première fois que vous appuyez sur l'un d'eux, InfraNest vous envoie un message privé avec un bouton Link my account. Ouvrez-le pendant que vous êtes connecté à InfraNest, puis appuyez de nouveau sur le bouton dans Slack. Vous ne le faites qu'une seule fois par espace de travail Slack.

Create issue apparaît sous une alerte lorsque votre espace de travail a Jira, Linear ou GitHub connecté dans Intégrations et que l'incident n'a pas encore de ticket. Appuyer dessus crée l'incident dans votre outil de suivi et publie la clé et le lien du ticket dans le fil de l'alerte. Le bouton se transforme alors en cette clé, afin que tout le monde puisse ouvrir le ticket depuis l'alerte. Appuyer dessus deux fois, ou deux personnes appuyant en même temps, ne crée toujours qu'un seul ticket. Si plusieurs outils de suivi ou projets pourraient le prendre en charge et qu'aucun n'est défini par défaut, vous recevez un message privé avec Open the incident à la place, et vous choisissez à cet endroit.

Tant qu'un incident est ouvert, l'alerte dispose aussi d'Ask Claude, qui ouvre Claude avec l'enquête de l'incident déjà prête (sur les forfaits incluant les incidents).

Quand une automatisation attend une approbation et envoie sa demande à un canal Slack, le message comporte Approve et Reject…. Reject vous demande d'abord de confirmer.

Enregistrer un message en tant que note : choisissez Add to incident as note dans le menu de n'importe quel message (⋯ › More message shortcuts). Dans le fil d'une alerte, elle est associée à l'incident de cette alerte ; ailleurs, vous choisissez l'incident. Post status update se trouve aussi dans le menu de raccourcis de Slack (le bouton ⚡ ou + à côté de la zone de saisie).

#Utiliser /infranest

Tapez /infranest dans n'importe quel canal ou message privé. Vous seul voyez la réponse.

1. /infranest status affiche ce qui requiert votre attention immédiatement.
2. /infranest status api.example.com affiche l'état d'un moniteur, domaine ou serveur donné. Vous pouvez utiliser un nom, une URL ou un identifiant.
3. /infranest update liste les incidents ouverts sur lesquels vous pouvez publier une mise à jour de statut publique, chacun avec un bouton Post status update.
4. /infranest pause met vos propres alertes en pause pendant une heure. Utilisez /infranest pause tomorrow jusqu'au matin, ou /infranest pause week. /infranest back les réactive.
5. /infranest run liste les automatisations manuelles que vous pouvez exécuter, chacune avec un bouton Run qui vous demande d'abord de confirmer. /infranest run backup affine la liste.
6. /infranest link relie votre Slack à votre compte InfraNest, si ce n'est pas déjà fait.
7. /infranest help liste toutes ces commandes.

L'application InfraNest dans Slack dispose aussi d'un onglet Home. Il affiche si vos alertes sont en pause (avec des boutons pour changer cela), ce qui est ouvert, qui est d'astreinte quand PagerDuty est connecté, et quel canal reçoit les alertes de quel espace de travail.

#Mentionner quelqu'un en cas de panne

1. Ouvrez la page de la destination Slack.
2. Sous Mention on an outage, choisissez qui l'alerte mentionne : personne, @here, l'un de vos groupes d'utilisateurs Slack (comme @oncall), ou la personne indiquée par PagerDuty comme étant d'astreinte pour ce moniteur.

La mention n'a lieu que sur l'alerte qui ouvre une panne, jamais sur les mises à jour ou lors de la résolution. L'option d'astreinte nécessite que cette personne ait lié son compte Slack.

#Choisir ce qu'un canal reçoit, et quand

1. Sur la page de la destination Slack, utilisez What should this destination hear? pour choisir All events ou Urgent only.
2. Définissez Hours (optional) avec les horaires (et jours) pendant lesquels il doit tout recevoir ; en dehors, il ne reçoit que les événements critiques, afin qu'une panne passe quand même.
3. Activez le « Needs you » digest pour publier la même liste que l'e-mail « a besoin de vous » dans le canal — Daily, ou Weekly, on Monday — le matin, et seulement lorsqu'un nouvel élément apparaît.

Sous Alertes → Destinations d'alerte, Monthly test envoie une alerte de test au canal une fois par mois, afin qu'un canal qui a cessé de fonctionner soit détecté avant qu'une panne ne survienne.

#Coller un lien InfraNest

Collez un lien vers un moniteur, un domaine ou un serveur d'InfraNest dans un canal, et Slack affiche son nom, son état, et qui s'en occupe, avec un bouton Open. Cet aperçu n'apparaît que pour les éléments de votre propre espace de travail, dans un espace de travail Slack où InfraNest est installé.

Si vous avez ajouté InfraNest à Slack avant l'arrivée de cette fonctionnalité, ajoutez-le de nouveau à Slack une fois : sous Intégrations → Slack, sélectionnez Add account et choisissez le même espace de travail sur l'écran de Slack.

#Recevoir vos propres alertes en messages privés Slack

1. Vérifiez que votre compte Slack est lié.
2. Allez dans My account › Notifications.
3. Sélectionnez Add Telegram or Slack, puis choisissez Slack.

Vos propres alertes arrivent alors en messages privés de la part d'InfraNest, et se mettent à jour automatiquement quand un problème est résolu. Chacune comporte vos propres boutons en dessous, comme Acknowledge, Silence 1 h, Remind me in 7 days ou Approve pour une demande d'adhésion. Ils ne fonctionnent que pour vous, et tout ce qui est irréversible vous demande d'abord de confirmer. Il n'y a rien à coller. Si votre équipe n'a pas ajouté InfraNest à Slack, un lien de webhook vous sera demandé à la place.

Changer de canal : ouvrez la destination sous Intégrations → Slack et sélectionnez Change channel. Son nom, ses alertes et ses paramètres restent les mêmes.

Vous utilisez déjà un webhook ? Ouvrez la destination et sélectionnez Move to the InfraNest app, puis choisissez le canal. Son nom, ses alertes et ses paramètres restent les mêmes, et à partir de là, ses alertes se mettent à jour automatiquement quand un problème est résolu.

Plusieurs espaces de travail : reconnectez-vous et choisissez l'autre espace de travail sur l'écran de Slack. Chaque espace de travail est listé séparément sous Slack workspaces.

#Se connecter via un webhook à la place

Si vous préférez ne pas ajouter l'application InfraNest à votre espace de travail, vous pouvez coller une URL du webhook entrant à la place. Les alertes arrivent de la même façon, mais elles ne peuvent pas se mettre à jour automatiquement quand un problème est résolu : la résolution est publiée comme un nouveau message qui nomme l'alerte qu'elle clôture.

1. Dans Slack, ajoutez une application Incoming Webhooks à votre espace de travail (ou ouvrez celle qui existe déjà), choisissez le canal, et copiez l'URL du webhook. Traitez-la comme un mot de passe.
2. Dans InfraNest, allez dans Intégrations → Slack, ouvrez Connecter et choisissez l'option webhook.
3. Collez l'URL de webhook Slack, puis sélectionnez Envoyer un test.

#Envoyer des alertes vers Slack

Une fois la destination enregistrée, choisissez Slack quand vous décidez quelles alertes vont où — par exemple un moniteur qui tombe en panne, un domaine sur le point d'expirer, ou un avertissement de certificat.

#Astuces

TipTant que vos alertes ne vont qu'à l'e-mail, chaque e-mail d'alerte se termine par Get this in Slack next time. Il ouvre Slack dans InfraNest, prêt à être connecté.

• Chaque page de moniteur (dans son onglet Alerts & Dependencies) et page de serveur affiche Who hears about this? : les destinations et les personnes que ses alertes atteignent, avec Add Slack à côté.
• Juste après avoir ajouté Slack, sélectionnez Envoyer un test pour vérifier qu'une alerte arrive dans le canal attendu. Une destination qui n'a encore rien reçu continue de proposer le test sous Alertes → Destinations d'alerte.

#Dépannage

• InfraNest retiré de Slack, ou le canal a été archivé : la destination est immédiatement marquée comme nécessitant une attention et vous en êtes informé par e-mail. Ajoutez de nouveau InfraNest à Slack, ou choisissez un autre canal.
• Vous n'êtes pas sûr que ça fonctionne encore ? Ouvrez le menu ⋯ d'un espace de travail sous Slack workspaces et sélectionnez Check connection. Cela demande à Slack si InfraNest peut encore publier dans chaque canal, et propose la solution — Add to Slack again, Pick another channel, ou inviter @InfraNest dans un canal privé.
• Suppression d'un espace de travail : retirez d'abord les destinations Slack qui l'utilisent. Remove workspace apparaît alors dans le menu ⋯ de l'espace de travail.

InfraNest ne publie que dans les canaux que vous choisissez et ne lit jamais vos messages. Chaque canal que vous choisissez est une destination — ajoutez un autre canal pour une équipe différente.