Intégration à Salesforce (aperçu public)
Vous pouvez désormais créer des incidents dans l' Salesforce via Instana.
Une fois que vous avez créé un canal d'alerte Salesforce dans l'interface utilisateur d' Instana, toutes les notifications d'alerte envoyées par Instana peuvent être transmises à Salesforce via le modèle d'objet d'incident de Salesforce.
Configuration du canal d'alerte « Salesforce »
Avant de configurer le canal d'alerte dans Instana, vous devez créer une application connectée au sein d'une organisation Salesforce. Pour plus d'informations sur le processus de configuration, consultez la section Configurer une application connectée pour le flux d'informations d'identification du client OAuth 2.0.
Création d'une application connectée à Salesforce
Vous devez configurer l'application connectée « Salesforce », qui se connecte à Instana, en sélectionnant les options suivantes sur la page de configuration :
Nom de l'application connectée : nom de l'application qui se connecte à Instana
Contacter Email : l'adresse e-mail d'une personne au sein de l'organisation qui connaît bien Instana et qui peut aider à résoudre d'éventuels problèmes
Activer les paramètres d' OAuth : vous devez activer OAuth car Instana utilise OAuth pour s'authentifier auprès de Salesforce.
URL de rappel : en raison de l'utilisation des informations d'identification du client dans le cadre du flux d'informations d'identification du client pour l'intégration serveur à serveur avec Salesforce, Instana n'utilise pas l' URL de rappel pour l'authentification. Vous pouvez saisir l'adresse Instana URL de votre organisation, par exemple
https://<instana_org_name>.instana.ioPortées sélectionnées d' OAuth : les portées suivantes doivent être ajoutées :
- Gestion des données utilisateur via des API (api)
- Effectuer des demandes à tout moment (refresh_token, offline_access)
Activer le flux d' OAuth s client : vous devez activer le flux d's client, car Instana utilise ce flux dans le cadre de l'intégration avec Salesforce.
Consultez l'exemple suivant de paramètres d'application connectés:

Configuration d'un utilisateur d'exécution pour le flux
Vous devez configurer un utilisateur d'exécution dans votre organisation Salesforce . Assurez-vous que le profil affecté à l'utilisateur dispose des droits de création, de lecture, de mise à jour et de suppression des objets d'incident Salesforce .
Pour configurer les droits d'accès, procédez comme suit:
Créez un profil en cliquant sur Administration > Utilisateurs > Profils dans l'interface utilisateur Salesforce . Après avoir créé un profil, éditez la configuration en cliquant sur Editer. Modifiez ensuite la section Droits d'accès aux objets standard afin qu'un nouveau profil puisse "modifier tous" les incidents, comme indiqué dans la capture d'écran suivante:

Vous pouvez modifier le profil utilisateur pour qu'il soit restreint ou ouvert selon vos besoins.
Créez un utilisateur qui utilise ce profil. Cet utilisateur est affecté en tant qu'utilisateur d'exécution pour l'application connectée précédemment créée. Pour créer un utilisateur, cliquez sur Administration > Utilisateurs > Utilisateurs > Nouvel utilisateur, entrez les données nécessaires, puis sélectionnez le profil d'utilisateur créé précédemment.
Ajoutez l'utilisateur que vous avez créé en tant qu'utilisateur d'exécution à l'application connectée précédemment créée en affichant l'application connectée que vous venez de créer et en cliquant sur Gérer.

Sur la page App Manager, cliquez sur Edit Policies.

Sur la page des règles d'application connectées, accédez à la section Flux de données d'identification du client et entrez le nom de l'utilisateur autorisé à modifier tous les objets d'incident Salesforce . Cliquez ensuite sur Enregistrer.

Vous pouvez maintenant utiliser l'application connectée pour créer et modifier des incidents Salesforce dans une organisation.
Configuration du canal d'alerte « Salesforce »
Vous devez ajouter le canal d'alerte « Salesforce » en cliquant sur Paramètres > Canaux d'alerte > Ajouter un canal d'alerte dans l'interface utilisateur d' Instana.
Pour effectuer des requêtes relatives à des incidents et générer des jetons Bearer, vous devez configurer le champ « URL » de l'organisation Salesforce afin qu'il pointe vers l'instance Salesforce de l'organisation URL. Un exemple d'une telle URL est https://<salesforce_org>.my.salesforce.com. Pour plus d'informations, consultez la section « Noms d'hôte de mon domaine », en particulier le type de nom d'hôte « Connexion ».

Détails de la charge utile de l'alerte
Les alertes sont reçues lorsqu'un événement est déclenché dans l'interface utilisateur d' Instana. Un point de terminaison « URL » est fourni lorsque vous créez un canal d'alerte « Salesforce ». La charge utile de l'alerte reçue est envoyée à ce point de terminaison URL.
Le contenu de l'alerte contient les informations suivantes:
- Subject: titre de l'événement
- Description: la description contient les zones suivantes:
- Lien vers Instana
- Description de l'événement
- Entité
- Hôte
- Zone personnalisée
- Zone de disponibilité
- Contenus personnalisés
- Instana Référence de l'incident
- Date et heure de détection : heure de début de l'événement
- EndDateTime : Heure de fin de l'événement
- Impact : les événements de l' Instana dont le niveau de gravité est « critique » sont associés à
highl'impact. Les événements de type « Instana » dont le niveau de gravité est «avertissement» sont associés àmediuml'impact, tandis que les autres événements sont associés àlowl'impact. - IsMajorIncident : Les événements de l' Instana dont la
criticalgravité est définie surtrue. - Priorité : les événements de l' Instana qui ont un niveau
criticalde gravité sont associés à lacriticalpriorité. Les événements de l' Instana qui ont unwarningniveau de gravité sont affectés à lamoderatepriorité, et les autres événements sont affectés à lalowpriorité. - Méthode de signalement : la source par laquelle l'incident a été signalé. Les informations sont toujours préremplies sur Instana.
- Date et heure de début : heure de début de l'événement
- Statut : Les événements de l' Instana qui sont ouverts sont répertoriés sous
new. Les événements de type « Instana » qui sont fermés sont mappés versclosed. Les épreuves tests de l' Instana e sont répertoriées sousresolved. - Urgence : les événements de l' Instana qui ont une
criticalgravité sont associés àhighl'urgence. Les événements de l' Instana qui ont unwarningniveau de gravité sont associés au niveaumediumd'urgence, et les autres événements sont associés au niveaulowd'urgence.
Dans le cadre de l'intégration avec Salesforce, les incidents ouverts via Instana doivent également être clôturés via Instana. Lorsqu'une notification d'alerte de fermeture est envoyée, Instana envoie une requête à Salesforce qui modifie le statut de l'incident Salesforce de New à Closed. Dans d'autres canaux d'alerte, vous obtenez une notification d'alerte fermée distincte qui ressemble à une nouvelle alerte. Pour les types d'alerte qui n'envoient pas de notification de clôture, l'incident d' resolvedSalesforce s commence avec le statut.
Salesforce Exemple d'incident créé par Instana
L'exemple suivant montre la charge d'alerte d'un événement de test avec le type Issue et le statut Resolved:
