View a markdown version of this page

Connecter Dynatrace - AWS DevOps Agent
Built-in, intégration bidirectionnelleConditions préalablesIntégrationEnlèvement

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Connecter Dynatrace

Built-in, intégration bidirectionnelle

Actuellement, AWS DevOps Agent prend en charge les utilisateurs de Dynatrace grâce à une intégration bidirectionnelle intégrée qui permet les opérations suivantes :

  • Cartographie des ressources topologiques  : AWS DevOps l'agent complétera la topologie de votre espace d' DevOps agent avec les entités et les relations disponibles dans votre environnement Dynatrace.

  • Déclenchement automatique des enquêtes - Les flux de travail Dynatrace peuvent être configurés pour déclencher des enquêtes de résolution d'incidents à partir de problèmes Dynatrace.

  • Introspection télémétrique  : l' AWS DevOps agent peut effectuer une introspection de la télémétrie Dynatrace lorsqu'il étudie un problème via le serveur Dynatrace MCP. AWS DevOps Agent-hosted

  • Mises à jour de statut  : AWS DevOps l'agent publiera les principaux résultats de l'enquête, les analyses des causes profondes et les plans d'atténuation générés sur l'interface utilisateur de Dynatrace.

Conditions préalables

L'intégration de l' AWS DevOps Agent à Dynatrace nécessite Dynatrace SaaS. L'intégration dépend des fonctionnalités de la plateforme Dynatrace (flux de travail, AppEngine applications telles que l'application SRE Agents et clients OAuth) qui ne sont disponibles que dans les environnements SaaS Dynatrace.

Dynatrace Managed (sur site) n'est pas pris en charge et Dynatrace n'a pas l'intention d'intégrer ces fonctionnalités de plateforme à Managed. Si vous utilisez Dynatrace Managed, vous devrez passer à Dynatrace SaaS avant de le connecter à Agent. AWS DevOps Consultez la section Mise à niveau de Dynatrace Managed vers le SaaS.

Intégration

Processus d'intégration

L'intégration de votre système d'observabilité Dynatrace comporte trois étapes :

  1. Connexion  : établissez une connexion à Dynatrace en configurant les informations d'accès au compte, avec tous les environnements dont vous pourriez avoir besoin

  2. Activer  : activez Dynatrace dans des espaces d'agents spécifiques avec des environnements Dynatrace spécifiques

  3. Configurez votre environnement Dynatrace  : utilisez l'application Dynatrace SRE Agents pour établir la connexion en 2 clics

Étape 1 : Connexion

Établissez une connexion à votre environnement Dynatrace

Configuration

  1. Accédez à la page Capability Providers (accessible depuis la navigation latérale)

  2. Trouvez Dynatrace dans la section «  Fournisseurs disponibles » sous Télémétrie et choisissez « S'inscrire »

  3. Créez un client OAuth dans Dynatrace, avec les autorisations détaillées.

    1. Voir la documentation Dynatrace

    2. Lorsque vous êtes prêt, appuyez sur Suivant

    3. Vous pouvez connecter plusieurs environnements Dynatrace et les étendre ultérieurement à des environnements spécifiques pour chaque espace d' DevOps agent dont vous disposez.

  4. Entrez vos informations Dynatrace depuis la configuration du client OAuth :

    • Nom du client

    • Identifiant du client

    • Secret du client

    • Compte URN

  5. Choisissez Next (Suivant)

  6. Réviser et ajouter

Chaque enregistrement se connecte à un client Dynatrace OAuth. Pour connecter d'autres comptes Dynatrace, répétez cette procédure pour chacun d'entre eux.

Étape 2 : activer

Activez Dynatrace dans un espace d'agent spécifique et configurez la portée appropriée

Configuration

  1. Sur la page des espaces d'agent, sélectionnez un espace d'agent et appuyez sur Afficher les détails

  2. Sélectionnez l'onglet Capacités

  3. Localisez la section Télémétrie, appuyez sur Ajouter

  4. Dynatrace apparaît avec le statut Enregistré. Choisissez Ajouter pour ajouter l'inscription que vous souhaitez à votre espace agent.

  5. ID d'environnement Dynatrace : indiquez l'identifiant d'environnement Dynatrace que vous souhaitez associer à cet espace d'agent. DevOps

  6. Entrez un ou plusieurs identifiants d'entité Dynatrace. Ils permettent à l' DevOps agent de découvrir vos ressources les plus importantes, par exemple des services ou des applications. Si vous n'êtes pas sûr, vous pouvez appuyer sur Supprimer.

  7. Vérifiez et appuyez sur Enregistrer

  8. Copiez l'URL du Webhook et le code secret du Webhook. Vous les utiliserez dans l'application Dynatrace SRE Agents pour terminer la connexion. Consultez la section Mise en route pour plus de détails.

Un seul espace d'agent peut utiliser plusieurs enregistrements Dynatrace et plusieurs environnements pour chacun d'eux. Pour ajouter un autre enregistrement ou un autre environnement, répétez ces étapes.

Étape 3 : Configuration de votre environnement Dynatrace

Pour terminer la configuration de Dynatrace, utilisez l'application Dynatrace SRE Agents pour configurer le côté Dynatrace de l'intégration en 2 clics. Aucune configuration manuelle du flux de travail n'est nécessaire. Pour plus de détails, consultez la section Mise en route.

Schémas d'événements pris en charge

AWS DevOps L'agent prend en charge deux types d'événements provenant de Dynatrace à l'aide de webhooks. Les schémas d'événements pris en charge sont documentés ci-dessous :

Incident et événement

Les incidents sont utilisés pour déclencher une enquête. Le schéma de l'événement est le suivant :

{
    "event.id": string;
    "event.status": "ACTIVE" | "CLOSED";
    "event.status_transition": string;
    "event.description": string;
    "event.name": string;
    "event.category": "AVAILABILITY" | "ERROR" | "SLOWDOWN" | "RESOURCE_CONTENTION" | "CUSTOM_ALERT" | "MONITORING_UNAVAILABLE" | "INFO";
    "event.start"?: string;
    "affected_entity_ids"?: string[];
}
Événement d'atténuation

Les événements d'atténuation sont utilisés pour déclencher la génération d'un rapport d'atténuation pour l'enquête sur les prochaines étapes. Le schéma de l'événement est le suivant :

{
    "task_id": string;
    "task_version": number;
    "event.type": "mitigation_request";
}

Enlèvement

La source de télémétrie est connectée à deux niveaux au niveau de l'espace agent et au niveau du compte. Pour le supprimer complètement, vous devez d'abord le supprimer de tous les espaces d'agent où il est utilisé, puis vous pouvez le désenregistrer.

Étape 1 : Supprimer de l'espace agent

  1. Sur la page des espaces d'agent, sélectionnez un espace d'agent et appuyez sur Afficher les détails

  2. Sélectionnez l'onglet Capacités

  3. Faites défiler la page jusqu'à la section Télémétrie

  4. Sélectionnez Dynatrace

  5. Appuyez sur Supprimer

Étape 2 : Désenregistrer du compte

  1. Accédez à la page Capability Providers (accessible depuis la navigation latérale)

  2. Accédez à la section Actuellement enregistré.

  3. Vérifiez que le nombre d'espaces d'agent est égal à zéro (si ce n'est pas le cas, répétez l'étape 1 ci-dessus dans vos autres espaces d'agent)

  4. Sélectionnez Dynatrace, puis choisissez Désenregistrer dans le menu Actions.