Office 365 /Canal d'alerte Microsoft Teams

Pour envoyer des notifications d'alerte depuis Instana vers Office 365 ou Microsoft Teams, créez un canal d'alerte.

Les notifications d'alerte sont envoyées en temps réel à Office 365 ou à Microsoft Teams à l'aide de workflows ou de webhooks entrants.

Prérequis

Modifier en ligne

Avant de commencer, assurez-vous de disposer d'un workflow ou d'un webhook URL pour vous connecter à Office 365 ou Microsoft Teams.

Important : Office 365 obsolescence des connecteurs: À compter du Retrait des Office 365 connecteurs au sein de Microsoft Teams, la possibilité de créer de nouveaux connecteurs sera désactivée après le 15 août 2024. Les webhooks existants sont pris en charge jusqu'à ce que Microsoft les supprime complètement. Consultez les instructions suivantes pour migrer vers les flux de travail au plus tôt.

Étapes de migration vers les workflows : pour migrer depuis des canaux d'alerte existants qui utilisent une URL de webhook URL, remplacez le champ « Workflow / Webhook » URL de l'interface utilisateur par une URL de workflow valide URL. Suivez la procédure suivante intitulée « Obtenir un workflow ou un webhook » ( URL ) pour créer les URL de workflow de votre chaîne.

Remarque : des modifications ont été apportées à la présentation des alertes reçues via les workflows, car celles-ci utilisent un modèle de type « AdaptiveCard ». Les canaux d'alerte existants qui utilisent un webhook entrant URL suivent l'ancienne conception et utilisent le modèle MessageCard. Pour plus d'informations sur les modifications apportées à la conception, consultez la section « Exemples d'alertes ».

Obtenir un flux de travail ou un webhook URL

Modifier en ligne

Flux de travail : suivez les instructions de Microsoft pour créer un flux de travail à l'aide du modèle Post to a channel when a webhook request is received.

Vérifiez les paramètres d'autorisation requis pour les canaux d' Microsoft Teams.

Canal public : si la modération du canal est activée, veillez à sélectionner l'autorisation Allow bots to submit channel messages correspondante dans les paramètres du canal « Microsoft Teams ».
Canal privé: Par défaut, les robots de workflow ne prennent pas en charge l'envoi de messages sur des canaux privés. En guise de solution de contournement, modifiez le flux de travail pour publier en tant qu'utilisateur.

Webhooks entrants : il ne sera plus possible de créer de nouveaux connecteurs de webhooks entrants sur Microsoft Teams après le 15 août 2024. Pour migrer des webhooks entrants existants vers des workflows, suivez les étapes décrites dans la section Workflows et mettez à jour l' URL du webhook du canal d'alerte Instana avec l' URL du workflow.

Pour configurer une interface Incoming Webhook en vue de l'intégration du canal d'alerte Office 365 ou Microsoft Teams, consultez l'article « Envoyer des requêtes externes vers Teams avec Incoming Webhook ».

Créer un canal d'alerte Office 365 ou Microsoft Teams

Modifier en ligne

Utilisez l'interface utilisateur d' Instana pour configurer votre canal d'alerte :

Dans le menu principal, cliquez sur Paramètres > Paramètres généraux.
Dans la section Événements et alertes, cliquez sur Canaux d'alerte.
Cliquez sur « Ajouter un canal d'alerte ».
Dans la fenêtre « Ajouter un canal d'alerte », sélectionnez Office 365 / Microsoft Teams dans la liste des canaux unidirectionnels disponibles. Cliquez ensuite sur « Ajouter un canal d'alerte ».
Configurez les paramètres de votre canal d'alerte :
- Nom : Saisissez un nom unique permettant d'identifier le canal.
- Flux de travail / Webhook URL : saisissez l' URL s relatives au flux de travail ou au webhook configuré pour l'envoi des notifications d'alerte.
- Vous pouvez cliquer sur « Tester le canal » pour vérifier si les paramètres du canal configurés sont valides et si celui-ci peut recevoir une notification de test.
- Équipes : vous pouvez, si vous le souhaitez, attribuer un tag au canal afin que les membres de l'équipe ou des équipes concernées puissent le retrouver plus facilement dans l'interface utilisateur.
(Facultatif) Développez la section « Avancé » pour personnaliser les notifications :
- - Ajouter un fuseau horaire : définissez un fuseau horaire spécifique pour que les destinataires voient les messages à l'heure locale plutôt qu'à l'heure UTC par défaut.
  
  Figure 1. Ajouter un fuseau horaire
  
  Pour ajouter un fuseau horaire, cliquez sur « Ajouter un fuseau horaire ». Sélectionnez ensuite le fuseau horaire souhaité pour les notifications d'alerte.

Exemples d'alertes

Modifier en ligne

Une fois le canal d'alerte créé, Instana envoie les alertes relatives aux événements sous forme d' HTTP s au flux de travail POSTOffice 365 ou Microsoft Teams, ou à l'adresse Webhook URL ( HTTP ou HTTPS ), qui est l'adresse à laquelle les alertes sont envoyées.