Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Azure Managed Instance pour Apache Cassandra fournit des métriques et une journalisation des diagnostics via Azure Monitor.
Note
Cet article contient une référence au terme whitelist, que Microsoft n’utilise plus. Lorsque le terme sera supprimé du logiciel, nous le supprimerons de cet article.
Métriques de Azure Managed Instance pour Apache Cassandra
Vous pouvez visualiser des métriques pour Azure Managed Instance pour Apache Cassandra dans le portail Azure en accédant à votre ressource de cluster et en sélectionnant Métriques. Vous pouvez ensuite choisir parmi les métriques et agrégations disponibles.
Paramètres de diagnostic dans Azure
Azure Monitor utilise des paramètres de diagnostic pour collecter les journaux de ressources, également appelés journaux du plan de données. Une ressource Azure émet des journaux de ressources pour fournir des données riches et fréquentes sur ses opérations. Azure Monitor capte ces journaux par demande. Parmi les exemples d’opérations de plan de données, citons la suppression, l’insertion et readFeed. Le contenu de ces journaux d’activité varie en fonction du type de ressource.
Les métriques de plateforme et les journaux d’activité sont collectés automatiquement. Vous devez créer un paramètre de diagnostic pour collecter les journaux de ressources ou les transférer en dehors de Azure Monitor. Vous pouvez activer les paramètres de diagnostic pour Azure Managed Instance pour les ressources de cluster Apache Cassandra et envoyer des journaux de ressources aux sources suivantes :
- Espace de travail Log Analytics. Les données envoyées aux espaces de travail Log Analytics sont écrites dans des tables Diagnostics Azure (héritées) ou spécifiques aux ressources (préversion).
- Event Hub.
- Compte de stockage.
Note
Nous vous recommandons de créer le paramètre de diagnostic en mode spécifique aux ressources.
Créer des paramètres de diagnostic à l’aide du portail Azure
Connectez-vous au portail Azure.
Accédez à votre ressource de cluster Azure Managed Instance pour Apache Cassandra.
Sélectionnez Paramètres de diagnostic dans la section Surveillance , puis sélectionnez Ajouter un paramètre de diagnostic.
Dans le volet Paramètres de diagnostic , choisissez un nom pour votre paramètre.
Sous Détails de catégorie, sélectionnez vos catégories. La catégorie CassandraLogs enregistre les opérations du serveur Cassandra. La catégorie CassandraAudit enregistre l’audit et les opérations CQL (Cassandra Query Language).
Sous Détails de destination, choisissez votre destination préférée pour vos journaux d’activité. Pour envoyer des journaux à un espace de travail Log Analytics, veillez à sélectionner Ressource spécifique comme table de destination.
Note
Si vous envoyez des journaux à un espace de travail Log Analytics, ils peuvent mettre jusqu'à 20 minutes à apparaître. D'ici là, les tables spécifiques aux ressources, affichées sous Azure Managed Instance pour Apache Cassandra, ne sont pas visibles.
Une fois que vous avez configuré la journalisation des diagnostics et que les données circulent, vous pouvez sélectionner Logs et interroger les journaux de diagnostic disponibles à l’aide de Azure Data Explorer. Pour plus d’informations sur Azure Monitor et le langage de requête Kusto, consultez Requêtes de journal dans Azure Monitor.
Créer un paramètre de diagnostic à l’aide du Azure CLI
Pour créer un paramètre de diagnostic à l’aide d’Azure CLI, utilisez la commande az monitor diagnostic-settings create :
logs='[{"category":"CassandraAudit","enabled":true,"retentionPolicy":{"enabled":true,"days":3}},{"category":"CassandraLogs","enabled":true,"retentionPolicy":{"enabled":true,"days":3}}]'
resourceId='/subscriptions/{SUBSCRIPTION_ID}/resourceGroups/{RESOURCE_GROUP}/providers/Microsoft.DocumentDB/cassandraClusters/{CLUSTER_NAME}'
workspace='/subscriptions/{SUBSCRIPTION_ID}/resourcegroups/{RESOURCE_GROUP}/providers/microsoft.operationalinsights/workspaces/{WORKSPACE_NAME}'
az monitor diagnostic-settings create --name tvk-diagnostic-logs-cassandra --resource $resourceId --logs $logs --workspace $workspace --export-to-resource-specific true
Créer un paramètre de diagnostic à l’aide de l’API REST
Utilisez l’API REST Azure Monitor pour créer un paramètre de diagnostic à l’aide de la console interactive. Pour plus d’informations, consultez Paramètres de diagnostic.
Note
Nous vous recommandons de définir la propriété logAnalyticsDestinationType sur Dedicated pour activer les tables spécifiques aux ressources.
Requête
PUT
https://management.azure.com/{resource-id}/providers/microsoft.insights/diagnosticSettings/service?api-version={api-version}
En-têtes
| Paramètres/en-têtes | Valeur/Description |
|---|---|
name |
Nom de votre paramètre de diagnostic |
resourceUri |
subscriptions/{SUBSCRIPTION_ID}/resourceGroups/{RESOURCE_GROUP}/providers/Microsoft.DocumentDb/databaseAccounts/{ACCOUNT_NAME}/providers/microsoft.insights/diagnosticSettings/{DIAGNOSTIC_SETTING_NAME} |
api-version |
2017-05-01-preview |
Content-Type |
application/json |
Body
{
"id": "/subscriptions/{SUBSCRIPTION_ID}/resourceGroups/{RESOURCE_GROUP}/providers/Microsoft.DocumentDb/databaseAccounts/{ACCOUNT_NAME}/providers/microsoft.insights/diagnosticSettings/{DIAGNOSTIC_SETTING_NAME}",
"type": "Microsoft.Insights/diagnosticSettings",
"name": "name",
"location": null,
"kind": null,
"tags": null,
"properties": {
"storageAccountId": null,
"serviceBusRuleId": null,
"workspaceId": "/subscriptions/{SUBSCRIPTION_ID}/resourcegroups/{RESOURCE_GROUP}/providers/microsoft.operationalinsights/workspaces/{WORKSPACE_NAME}",
"eventHubAuthorizationRuleId": null,
"eventHubName": null,
"logs": [
{
"category": "CassandraAudit",
"categoryGroup": null,
"enabled": true,
"retentionPolicy": {
"enabled": false,
"days": 0
}
},
{
"category": "CassandraLogs",
"categoryGroup": null,
"enabled": true,
"retentionPolicy": {
"enabled": false,
"days": 0
}
}
],
"logAnalyticsDestinationType": "Dedicated"
},
"identity": null
}
Liste blanche d’audit
Note
Cet article contient des références au terme liste verte, que Microsoft n’utilise plus. Lorsque le terme sera supprimé du logiciel, nous le supprimerons de cet article.
Par défaut, la journalisation d’audit crée un enregistrement pour chaque tentative de connexion et requête CQL. Cela peut être excessif et augmenter la surcharge. Pour gérer cette situation, vous pouvez utiliser une liste blanche pour inclure ou exclure de manière sélective des enregistrements d’audit spécifiques.
Cassandra 3.11
Dans Cassandra 3.11, vous pouvez utiliser la fonctionnalité de liste blanche d’audit pour définir les opérations qui ne créent pas d’enregistrement d’audit. La fonctionnalité de liste verte d’audit est activée par défaut dans Cassandra 3.11. Pour savoir comment configurer votre whitelist, consultez la gestion de la whitelist basée sur les rôles.
Exemples :
Pour filtrer toutes les opérations
SELECTetMODIFYpour l’utilisateurbobà partir du journal d’audit, exécutez les instructions suivantes :cassandra@cqlsh> ALTER ROLE bob WITH OPTIONS = { 'GRANT AUDIT WHITELIST FOR SELECT' : 'data' }; cassandra@cqlsh> ALTER ROLE bob WITH OPTIONS = { 'GRANT AUDIT WHITELIST FOR MODIFY' : 'data' };Pour filtrer toutes les
SELECTopérations sur ladecisionstable dans l’espace de clés de l’utilisateurdesignjimà partir du journal d’audit, exécutez l’instruction suivante :cassandra@cqlsh> ALTER ROLE jim WITH OPTIONS = { 'GRANT AUDIT WHITELIST FOR SELECT' : 'data/design/decisions' };Pour révoquer la liste blanche pour l’utilisateur
bobsur toutes les opérationsSELECTde l’utilisateur, exécutez l’instruction suivante :cassandra@cqlsh> ALTER ROLE bob WITH OPTIONS = { 'REVOKE AUDIT WHITELIST FOR SELECT' : 'data' };Pour afficher les listes blanches actuelles, exécutez l’instruction suivante :
cassandra@cqlsh> LIST ROLES;
Cassandra 4 et versions ultérieures
Dans Cassandra 4 et versions ultérieures, vous pouvez configurer votre liste blanche dans la configuration de Cassandra. Pour plus d’informations, consultez Mettre à jour la configuration de Cassandra. Les options disponibles sont les suivantes (référence : documentation Cassandra pour la journalisation d’audit) :
audit_logging_options:
included_keyspaces: <Comma separated list of keyspaces to be included in audit log, default - includes all keyspaces>
excluded_keyspaces: <Comma separated list of keyspaces to be excluded from audit log, default - excludes no keyspace except system, system_schema and system_virtual_schema>
included_categories: <Comma separated list of Audit Log Categories to be included in audit log, default - includes all categories>
excluded_categories: <Comma separated list of Audit Log Categories to be excluded from audit log, default - excludes no category>
included_users: <Comma separated list of users to be included in audit log, default - includes all users>
excluded_users: <Comma separated list of users to be excluded from audit log, default - excludes no user>
Les catégories disponibles sont les suivantes : QUERY, DML, DDL, AUTH, DCL, OTHER, ERROR, PREPARE.
Voici un exemple de configuration :
audit_logging_options:
included_keyspaces: keyspace1,keyspace2
included_categories: AUTH,ERROR,DCL,DDL
Par défaut, la configuration définit included_categories sur AUTH,ERROR,DCL,DDL.
Étape suivante
- Pour plus d’informations sur la création d’un paramètre de diagnostic à l’aide du portail Azure, du Azure CLI ou de PowerShell, consultez les paramètres de diagnostic dans Azure Monitor.