scénario : création de dimensions pour une cible Monitoring

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

Le workflow de création du connecteur inclut une stratégie par défaut lorsque nécessaire afin de fournir des droits d'accès en écriture au service cible. Si vous ne connaissez pas les stratégies, reportez-vous à Présentation des stratégies IAM.

Cette rubrique décrit l'objectif de ce scénario.

L'objectif de ce scénario est d'appliquer un filtre aux événements d'actualisation pour les buckets Object Storage. Par exemple, rechercher les mises à jour qui ont fait passer des buckets en accès public. La recherche de buckets publics peut empêcher la fuite de clés secrètes. Outre le type d'accès public, ce scénario configure des filtres pour le nom de bucket, le nom de compartiment, le domaine de disponibilité, le statut de gestion des versions et une valeur statique.

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

Ce scénario crée une mesure à partir d'un journal à l'aide du service Connector Hub. La configuration de ce scénario implique les étapes suivantes :

• Créez un connecteur pour déplacer les journaux de Logging vers une mesure personnalisée avec les dimensions dans Monitoring.

  • Données de journal : événement Bucket - Mise à jour à partir des journaux d'audit (groupe des journaux _Audit)

    Remarque
    
    Même si ce scénario utilise le groupe de journaux _Audit et l'événement de mise à jour de bucket, vous pouvez utiliser la même approche avec tous les journaux disponibles dans votre location.

  • Espace de noms de mesure : bucket_events

  • Nom de mesure : update

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

  • Valeur extraite à l'aide des dimensions de chemin :

    Remarque
    
    

    Chaque nouvelle valeur de dimension crée un flux de données de mesure. Pour éviter de générer trop de flux de données de mesure uniques, ce qui pourrait potentiellement aboutir à un étranglement, nous recommandons d'exclure des dimensions les GUID ou les UUID (comme les OCID de compartiment).

    Propriété de chemin (nom de 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

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

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

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

Pour plus d'informations sur le dépannage, reportez-vous à la section Troubleshooting Connectors et à la section Troubleshooting Notifications.

Cette rubrique explique 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 la signature des demandes, reportez-vous à la documentation relative à l'API REST et à Informations d'identification de sécurité. Pour plus d'informations sur les kits SDK, reportez-vous à Kits SDK et interface de ligne de commande.

1. Définissez la source de 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 la création d'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. Pour cela, ouvrez une invite de commande et exécutez la commande oci monitoring metric-data summarize-metrics-data :

   Exemple de commande pour l'interrogation des 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 plus d'informations sur le dépannage, reportez-vous à la section Troubleshooting Connectors et à la section Troubleshooting Notifications.

Cette rubrique explique 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 la signature des demandes, reportez-vous à la documentation relative à l'API REST et à Informations d'identification de sécurité. Pour plus d'informations sur les kits SDK, reportez-vous à Kits 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 plus d'informations sur le dépannage, reportez-vous à la section Troubleshooting Connectors et à la section Troubleshooting Notifications.