Afficher les métriques
Pour consulter les métriques en utilisant l’API des métriques comme source de données, vous pouvez utiliser différents logiciels tiers à déployer à l’intérieur ou l’extérieur de votre cluster.
Vous pouvez par exemple utiliser l’application Grafana avec l’API des métriques comme source de données et afficher les résultats dans un format de tableau de bord.
Remarque :
Avant ArcGIS Enterprise 11.2 sur Kubernetes, Grafana était disponible directement depuis l’API administrateur d’ArcGIS Enterprise, mais elle a depuis été retirée. Même si elle n’est plus accessible directement depuis le logiciel, vous pouvez toujours utiliser Grafana avec l’API des métriques en l’installant séparément.
Déterminer le modèle d’URL
Pour utiliser l’API des métriques comme source de données dans votre application tierce, vous devez inscrire son URL avec l’application.
Remarque :
Pour inscrire l’API comme source de données, vérifiez que son URL indique si elle est accessible en interne ou en externe par rapport au cluster.
Remarque :
Utilisez le modèle d’URL qui correspond à votre déploiement.
URL de service externe (utilisée en cas d’accès à l’API à l’intérieur ou à l’extérieur du cluster) :
https://<FQDN>/<context>/prometheusURL de service interne (utilisée en cas d’accès à l’API depuis le même cluster) :
http://arcgis-rest-metrics-api.<deploymentNamespace>.svc.cluster.local:8443/arcgis/prometheus
Ajouter Prometheus comme source de données
Pour utiliser l’API des métriques dans votre application, vous devez sélectionner Prometheus comme type de source de données.
Les étapes suivantes sont un exemple de ce traitement avec Grafana. D’autres applications utilisent toutefois des étapes semblables.
Dans l’interface utilisateur de Grafana, ouvrez le menu Configuration.
Cliquez sur Data Sources (Sources de données).
Cliquez sur Add Data Source (Ajouter une source de données).
Sélectionnez Prometheus comme type.
Pour l’URL du serveur, définissez l’URL de serveur Prometheus appropriée.
URL de service externe (utilisée en cas d’accès à l’API à l’intérieur ou à l’extérieur du cluster) :
https://<FQDN>/<context>/prometheusURL de service interne (utilisée en cas d’accès à l’API depuis le même cluster) :
http://arcgis-rest-metrics-api.<deploymentNamespace>.svc.cluster.local:8443/arcgis/prometheus
Définissez Access (Accès) sur Browser (Navigateur).
Activez Basic Auth (Authentification de base) et saisissez les informations d’identification que vous avez spécifiées lors de l’accès à l’API des métriques.
Cliquez sur Save (Enregistrer) et Test pour enregistrer la nouvelle source de données.
Exemples de modèle de tableau de bord
Une fois que vous avez inscrit l’API des métriques et défini Prometheus comme source, vous pouvez commencer à visualiser les données de service de votre organisation. Pour commencer, plusieurs exemples de modèle de tableau de bord Grafana sont disponibles dans le référentiel d’observabilité ArcGIS Enterprise. Vous pouvez importer ces tableaux de bord en chargeant un JSON du modèle ou en collant le texte JSON directement. Procédez comme suit pour importer ces exemples de tableau de bord Grafana.
Dans Grafana, cliquez sur Dashboards (Tableaux de bord).
Cliquez sur Nouveau.
Sélectionnez Import (Importer) dans le menu déroulant.
Procédez de l’une des manières suivantes :
Chargez un fichier
.jsonde tableau de bord à partir du modèle.Collez le texte
.jsondu tableau de bord directement dans la zone de texte copiée à partir du modèle.
Remarque :
Pendant le processus d’importation, vous pouvez changer le nom du tableau de bord, choisir la source de données à utiliser et spécifier les préfixes de métrique que le tableau de bord utilise.