Surveillance d'Azure Cosmos DB
Le capteur Azure CosmosDB est automatiquement déployé et installé une fois que vous avez installé l'agent Instana.
Azure Cosmos DB est le service de base de données multi-modèle de Microsoft, distribué à l'échelle mondiale. Instana permet de surveiller les indicateurs par collection et, selon le modèle utilisé, la surveillance des indicateurs spécifiques au modèle par collection est également prise en charge.
Les données sont organisées en descendant dans une hiérarchie constituée de 4 niveaux de métriques. Les métriques agrégées de l'instance s'affichent. Ces métriques s'appliquent à l'ensemble de l'instance Cosmos DB.
Le niveau suivant concerne les indicateurs par région. Les métriques de région sont agrégées sur toutes les collectes de la région concernée, mais elles contiennent également du trafic inter-régional et d'autres types de trafic. Cela signifie que les chiffres indiqués pour chaque région sont légèrement supérieurs à la somme du trafic de toutes les collections de cette région.
Le troisième niveau devient visible dès que vous développez une région. Vous trouverez ici les indicateurs par collection. Conformément au modèle de données, chaque collection comporte des indicateurs supplémentaires que vous pouvez consulter en développant la vue de la collection.
La fréquence de collecte des métriques est déterminée par le SDK Monitor d' Azure.
Informations complémentaires
Prise en charge du traçage côté client
Pour cette technologie, Instana prend en charge le traçage côté client pour les langages suivants :
Configuration
Le capteur Azure Cosmos DB peut être désactivé ou filtré par balises et groupes de ressources. Il est possible de configurer un capteur Azure CosmosDB à l'aide de la configuration de l'agent en <agentinstall_dir>/etc/instana/configuration.yaml :
com.instana.plugin.azure.cosmosdb:
# Valid values: true, false
enabled: false # enabled (true) by default
# Comma separated list of tags in key:value format
include_tags:
# Comma separated list of tags in key:value format
exclude_tags:
# Comma separated list of resource groups
include_resource_groups:
# Comma separated list of resource groups
exclude_resource_groups:
Le capteur Azure Cosmos DB peut être désactivé. Pour désactiver la surveillance des services Azure Cosmos DB, utilisez la configuration suivante :
com.instana.plugin.azure.cosmosdb:
enabled: false
Plusieurs balises et groupes de ressources peuvent être définis, en les séparant par une virgule. Les balises doivent être fournies sous forme de paire clé-valeur séparées par un signe deux-points (:). Pour faciliter la configuration, il est possible de définir les balises et les groupes de ressources que vous souhaitez inclure ou exclure de la reconnaissance. Lorsqu'on définit une balise ou un groupe de ressources dans les deux listes (inclusion et exclusion), la liste d'exclusion a la priorité. S'il n'est pas nécessaire de filtrer les services, la configuration ne doit pas être définie. Il n'est pas obligatoire de définir toutes les valeurs pour activer le filtrage.
Pour inclure des services par balises dans la reconnaissance, utilisez la configuration suivante :
com.instana.plugin.azure.cosmosdb:
include_tags: # Comma separated list of tags in key:value format (e.g. env:prod,env:staging)
Pour exclure des services par balises de la reconnaissance, utilisez la configuration suivante :
com.instana.plugin.azure.cosmosdb:
exclude_tags: # Comma separated list of tags in key:value format (e.g. env:dev,env:test)
Pour inclure des services par groupes de ressources dans la reconnaissance, utilisez la configuration suivante :
com.instana.plugin.azure.cosmosdb:
include_resource_groups: # Comma separated list of resource groups (e.g. rg_prod,rg_staging)
Pour exclure des services par groupes de ressources de la reconnaissance, utilisez la configuration suivante :
com.instana.plugin.azure.cosmosdb:
exclude_resource_groups: # Comma separated list of resource groups (e.g. rg_dev,rg_test)
Le filtrage de reconnaissance peut être configuré globalement pour tous les services Azure. Les filtres globaux sont remplacés lors de la définition de filtres pour le service Azure CosmosDB. Pour plus de détails sur le filtrage de reconnaissance de service Azure global, visitez le site Azure Configuration.
Collecte des métriques
Pour consulter les métriques, sélectionnez « Infrastructure » dans la barre latérale de l'interface utilisateur d' Instana, cliquez sur un hôte surveillé spécifique, puis vous verrez s'afficher un tableau de bord de l'hôte contenant toutes les métriques collectées et les processus surveillés.
Données de configuration
Liste des informations statiques par instance Cosmos DB.
| Détails de Cosmos DB | Description |
|---|---|
| Nom | Nom de l'instance Cosmos DB. |
| Groupe de ressources | Groupe de ressources de l'instance Cosmos DB. |
| Emplacement | Région principale où se trouve l'instance |
| ID abonnement | ID abonnement de l'instance Cosmos DB. |
| Etat | Etat de déploiement actuel de l'instance. |
| API | Type de modèle de document ( GlobalDB,, Cassandra ou MongoDB ) |
| Type | Type de document |
| Catégorie | Indique le type de compte de base de données |
| Noeud final | Noeud final de la base de données |
Récapitulatif
Premier niveau de métriques agrégées pour l'ensemble de l'instance Cosmos DB.
| Métrique de l'instance Cosmos DB | Description | Granularité |
|---|---|---|
| Nombre de documents | Nombre de documents figurant dans l'ensemble de l'instance | 5 minutes |
| Disponibilité du service | Exprimée en % | 1 heure |
| Nombre total de demandes | Nombre total de demandes | 1 minute |
| Demandes de métadonnées | Nombre total de demandes de métadonnées | 1 minute |
| Temps d'attente de lecture | 1 minute | |
| Temps d'attente d'écriture | 1 minute |
Régions
Les métriques par région contiennent des données agrégées pour toutes les collectes de cette région, plus les métriques apparaissant sur les niveaux de région comme les métriques inter-régionales ou les demandes de métadonnées.
| Métriques de région | Granularité |
|---|---|
| Nombre total de demandes | 1 minute |
| Demandes de métadonnées | 1 minute |
| Nombre de documents | 5 minutes |
Collections
Chaque région possède une ou plusieurs collections. Chaque collection dispose d'un ensemble de métriques accessibles quel que soit le modèle de document :
| Métriques de collecte | Description | Granularité |
|---|---|---|
| Nombre total de demandes | Nombre total de demandes | 1 minute |
| Demandes de métadonnées | Nombre de demandes de métadonnées | 1 minute |
| Nombre de documents | Nombre de documents stockés dans cette collection | 5 minutes |
| Utilisation des données | Nombre d'octets utilisés pour stocker tous les documents | 5 minutes |
| Utilisation de l'index | Quantité totale de stockage disponible | 5 minutes |
| Quota de documents | Quantité totale de stockage disponible pour stocker les documents | 5 minutes |
| Codes d'état | Mesures du nombre total de demandes par code d'état | 1 minute |
Sur la base du modèle de document ( API ), des indicateurs supplémentaires sont collectés :
Cassandra
| Métriques de collecte | Description | Granularité |
|---|---|---|
| Type de ressource | Demandes par type de ressource | 1 minute |
MongoDB
| Métriques de collecte | Description | Granularité |
|---|---|---|
| Type de commande | Demandes par type de commande | 1 minute |
| Code d'erreur | Demandes par code d'erreur | 1 minute |
Signatures d'intégrité
Pour chaque capteur, il existe une base de connaissances des signatures d'intégrité qui sont évaluées en permanence par rapport aux métriques entrantes et qui sont utilisées pour traiter les problèmes ou les incidents en fonction de l'impact sur l'utilisateur.
Les événements intégrés déclenchent des problèmes ou des incidents en fonction de signatures de santé défaillantes sur des entités, tandis que les événements personnalisés déclenchent des problèmes ou des incidents en fonction des seuils d'une métrique spécifique à une entité donnée.
Pour plus d'informations sur les événements générés pour le détecteur Azure CosmosDB , voir la référence des événements intégrés.