Aller au contenu principal

Dynatrace Rest API

Contenu du Pack​

Modèles​

Le connecteur de supervision Centreon Dynatrace Rest API apporte un modèle d'hôte :

  • App-Monitoring-Dynatrace-Restapi-custom

Il apporte les modèles de service suivants :

AliasModèle de serviceDescriptionDéfaut
ApdexApp-Monitoring-Dynatrace-Apdex-RestapiContrôle les APDEX des entitésX
AvailabilityApp-Monitoring-Dynatrace-Availability-RestapiContrôle la disponibilité des Synthetic MonitorsX
EventsApp-Monitoring-Dynatrace-Events-RestapiContrôle les évènementsX
ProblemsApp-Monitoring-Dynatrace-Problems-RestapiContrôle les problèmes ouvertsX

Métriques & statuts collectés​

Metric NameUnit
entity#apdex

Prérequis​

Un acces token doit être créé avec les droits suivants :

  • API v1:
    • DataExport
    • ReadConfig
  • API v2:
    • metrics.read
    • problems.read
    • events.read
    • syntheticLocations.read

Plus d'information sur la documentation officielle de Dynatrace : https://www.dynatrace.com/support/help/dynatrace-api/environment-api/tokens-v2/api-tokens

Installation​

  1. Installez le plugin sur tous les collecteurs Centreon devant superviser des ressources Dynatrace :
yum install centreon-plugin-Applications-Monitoring-Dynatrace-Restapi
  1. Sur l'interface web de Centreon, installez le connecteur de supervision Dynatrace Rest API depuis la page Configuration > Packs de plugins.

Configuration​

Hôte​

  • Ajoutez un hôte à Centreon depuis la page Configuration > Hôtes.
  • Complétez les champs Nom, Alias & IP Address/DNS correspondant à votre serveur Dynatrace.
  • Appliquez le modèle d'hôte App-Monitoring-Dynatrace-Restapi-custom.
  • Une fois le modèle appliqué, les macros ci-dessous indiquées comme requises (Obligatoire) doivent être renseignées.
ObligatoireMacroDescription
DYNATRACEAPIENVIRONMENTIDVotre environment ID
DYNATRACEAPIEXTRAOPTIONSOptions supplémentaires à ajouter à l'ensemble des commandes de l'hôte (ex: --verbose)
DYNATRACEAPIPASSWORDVotre access token
DYNATRACEAPIPORT(Défaut : '443')
DYNATRACEAPIPROTO(Défaut : 'https')

Comment puis-je tester le plugin et que signifient les options des commandes ?​

Une fois le plugin installé, vous pouvez tester celui-ci directement en ligne de commande depuis votre collecteur Centreon en vous connectant avec l'utilisateur centreon-engine (su - centreon-engine) :

/usr/lib/centreon/plugins//centreon_monitoring_dynatrace_restapi.pl \
--plugin=apps::monitoring::dynatrace::restapi::plugin \
--mode=apdex \
--hostname='10.0.0.1' \
--environment-id='' \
--api-password='' \
--port='443' \
--proto='https' \
--filter-entity='' \
--relative-time='2h'\
--aggregation-type='count' \
--warning-apdex='' \
--critical-apdex='' \
--verbose

La commande devrait retourner un message de sortie similaire à :

OK: All Apdex are OK | 'entity#apdex'=0.61;;;0;1 'entity#apdex'=0.88;;;0;1 

La liste de toutes les options complémentaires et leur signification peut être affichée en ajoutant le paramètre --help à la commande :

/usr/lib/centreon/plugins//centreon_monitoring_dynatrace_restapi.pl \
--plugin=apps::monitoring::dynatrace::restapi::plugin \
--mode=apdex \
--help

Tous les modes disponibles peuvent être affichés en ajoutant le paramètre --list-mode à la commande :

/usr/lib/centreon/plugins//centreon_monitoring_dynatrace_restapi.pl \
--plugin=apps::monitoring::dynatrace::restapi::plugin \
--list-mode

Diagnostic des erreurs communes​

Rendez-vous sur la documentation dédiée des plugins basés sur HTTP/API.