Scenario : créer des dimensions pour une cible de surveillance

Si vous êtes membre du groupe Administrateurs, vous disposez déjà de l'accès requis pour réaliser ce scénario. Sinon, vous devez avoir accès au service de surveillance .

Le flux de travail de création du connecteur inclut une politique par défaut, si nécessaire, afin de fournir l'autorisation d'écriture sur le service cible. Pour en savoir plus sur les politiques, voir Aperçu des politiques IAM.

Cette rubrique présente l'objectif de ce scénario.

L'objectif de ce scénario est de filtrer les événements de mise à jour pour les seaux de stockage d'objets. Par exemple, rechercher les mises à jour qui ont modifié les seaux en octroyant l'accès public. La recherche des seaux publics peut aider à empêcher les fuites d'informations confidentielles. Outre le type d'accès public, ce scénario configure des filtres pour le nom du seau, le nom du compartiment, le domaine de disponibilité, le statut de contrôle des versions et une valeur statique.

Cette rubrique décrit les tâches de configuration pour ce scénario.

Ce scénario crée une mesure à partir d'un journal à l'aide du service de centre de connecteurs. La configuration de ce scénario comprend les tâches suivantes :

• Créer un connecteur pour déplacer les journaux depuis le service de journalisation vers une mesure personnalisée avec des dimensions dans le service de surveillance.

  • Données de journal : Événement Seau - Mettre à jour dans les journaux de vérification (groupe de journaux _Audit)

    Note
    
    Bien que ce scénario utilise le groupe de journaux _Audit et l'événement de mise à jour de seau, vous pouvez utiliser la même approche avec n'importe quel journal disponible dans votre location.

  • Espace de noms de mesure : bucket_events

  • Nom de la mesure : update

  • Valeur statique buckets-from-connector (nom de la dimension : mytags)

  • Valeur extraite à l'aide des dimensions de chemin d'accès :

    Note
    
    

    Chaque nouvelle valeur de dimension crée un flux de mesures. Pour éviter de générer trop de flux de mesures uniques, ce qui pourrait entraîner des limitations, nous recommandons d'exclure des GUID ou des UUID (tels que les OCID de compartiment) des dimensions.

    Propriété de chemin (nom de la dimension)	Valeur
    bucketName	logContent.data.additionalDetails.bucketName
    compartmentName	logContent.data.compartmentName
    availabilityDomain	logContent.data.availabilityDomain
    publicAccessType	logContent.data.additionalDetails.publicAccessType
    versioning	logContent.data.additionalDetails.versioning

• Filtrer les données déplacées avec les dimensions (valeurs statiques et extraites).

Vous pouvez effectuer ces tâches dans la console Oracle Cloud Infrastructure, l'interface de ligne de commande ou l'API.

Cette rubrique décrit comment utiliser la console pour configurer le scénario.

Pour obtenir de l'aide concernant le dépannage, voir Dépannage des connecteurs et Dépannage des avis.

Cette rubrique décrit comment utiliser l'interface de ligne de commande pour créer le connecteur et filtrer les données déplacées.

Pour plus d'informations sur l'utilisation de l'API et sur les demandes de signature, voir la documentation de l'API REST et Données d'identification de sécurité. Pour plus d'informations sur les trousses SDK, voir Trousses SDK et interface de ligne de commande.

1. Définissez la source du journal pour le connecteur : Enregistrez un fichier nommé source.json.

   Exemple de fichier source.json

   {
     "kind": "logging",
     "logSources": [
       {
         "compartmentId": "<compartment_OCID>",
           "logGroupId": "_Audit",
           "logId": null
       }
     ]
   }

2. Définissez la cible (mesure et dimensions) pour le connecteur : Enregistrez un fichier nommé target.json.

   Exemple de fichier target.json

   {
     "kind": "monitoring",
     "compartmentId": "<compartment_OCID>",
     "metricNamespace": "bucket_events",
     "metric": "update",
     "dimensions": [
       {"name": "mytags", "dimensionValue": {"kind": "static", "value": "buckets-from-connector"}},
       {"name": "bucketName", "dimensionValue": {"kind": "jmesPath", "path": "logContent.data.additionalDetails.bucketName"}},
       {"name": "compartmentName", "dimensionValue": {"kind": "jmesPath", "path": "logContent.data.compartmentName"}},
       {"name": "availabilityDomain", "dimensionValue": {"kind": "jmesPath", "path": "logContent.data.availabilityDomain"}},
       {"name": "publicAccessType", "dimensionValue": {"kind": "jmesPath", "path": "logContent.data.additionalDetails.publicAccessType"}},
       {"name": "versioning", "dimensionValue": {"kind": "jmesPath", "path": "logContent.data.additionalDetails.versioning"}}
     ]
   }

3. Créez un connecteur : Ouvrez une invite de commande et exécutez la commande oci sch service-connector create :

   Exemple de commande pour créer un connecteur

   oci sch service-connector create
    --compartment-id <compartment_OCID>
    --display-name "Bucket - Update"
    --source file://source.json
    --target file://target.json

4. Interrogez les données de mesure à l'aide des dimensions personnalisées : Ouvrez une invite de commande et exécutez la commande oci monitoring metric-data summarize-metrics-data :

   Exemple de commande pour interroger les données de mesure à l'aide de dimensions personnalisées

   oci monitoring metric-data summarize-metrics-data
    --compartment-id <compartment_OCID>
    --namespace bucket_events
    --query-text update[1m]{mytags = "buckets-from-connector", bucketName = "bucket-20210722-1148", coompartmentName = "development", availabilityDomain = "PHX-AD-3", publicAccessType = "ObjectRead", versioning = "Enabled"}.count()

Pour obtenir de l'aide concernant le dépannage, voir Dépannage des connecteurs et Dépannage des avis.

Cette rubrique décrit comment utiliser l'API pour créer le connecteur et filtrer les données déplacées.

Pour plus d'informations sur l'utilisation de l'API et sur les demandes de signature, voir la documentation de l'API REST et Données d'identification de sécurité. Pour plus d'informations sur les trousses SDK, voir Trousses SDK et interface de ligne de commande.

Utilisez les opérations suivantes :

1. CreateServiceConnector : Créez un connecteur.

   Exemple de demande CreateServiceConnector

   POST /20200909/serviceConnectors
   Host: service-connector-hub.us-phoenix-1.oraclecloud.com
   <authorization and other headers>
   {
     "compartmentId": "<compartment_OCID>",
     "displayName": "Bucket - Update",
     "source": {
       "kind": "logging",
       "logSources": [
         {
           "compartmentId": "<compartment_OCID>",
           "logGroupId": "_Audit",
           "logId": null
         }
       ]
     },
     "target": {
       "compartmentId": "<compartment_OCID>",
       "dimensions": [
         {"name": "mytags", "dimensionValue": {"kind": "static", "value": "buckets-from-connector"}},
         {"name": "bucketName", "dimensionValue": {"kind": "jmesPath", "path": "logContent.data.additionalDetails.bucketName"}},
         {"name": "compartmentName", "dimensionValue": {"kind": "jmesPath", "path": "logContent.data.compartmentName"}},
         {"name": "availabilityDomain", "dimensionValue": {"kind": "jmesPath", "path": "logContent.data.availabilityDomain"}},
         {"name": "publicAccessType", "dimensionValue": {"kind": "jmesPath", "path": "logContent.data.additionalDetails.publicAccessType"}},
         {"name": "versioning", "dimensionValue": {"kind": "jmesPath", "path": "logContent.data.additionalDetails.versioning"}}
       ]
       "kind": "monitoring",
       "metric": "update",
       "metricNamespace": "bucket_events"
     }
   }

2. SummarizeMetricsData : Interrogez les données de mesure par dimension.

   Exemple de demande SummarizeMetricsData

   POST /20180401/metrics/actions/summarizeMetricsData?compartmentId=<compartment_OCID>
   Host: telemetry.us-phoenix-1.oraclecloud.com
   <authorization and other headers>
   {
     "namespace": "bucket_events",
     "query": "update[1m]{mytags = "buckets-from-connector", bucketName = "bucket-20210722-1148", coompartmentName = "development", availabilityDomain = "PHX-AD-3", publicAccessType = "ObjectRead", versioning = "Enabled"}.count()"
   }

Pour obtenir de l'aide concernant le dépannage, voir Dépannage des connecteurs et Dépannage des avis.