Scenario: creazione di dimensioni per una destinazione di monitoraggio

Se si è membri del gruppo Administrators, si dispone già dell'accesso necessario per completare questo scenario. In caso contrario, è necessario accedere a Monitoraggio.

Il workflow per la creazione del connettore include un criterio predefinito quando necessario per fornire l'autorizzazione per la scrittura nel servizio di destinazione. Per informazioni nuove sui criteri, vedere Panoramica dei criteri IAM.

Questo argomento descrive l'obiettivo di questo scenario.

L'obiettivo di questo scenario è filtrare gli eventi di aggiornamento per i bucket di storage degli oggetti. Ad esempio, trovare gli aggiornamenti che hanno modificato i bucket in accesso pubblico. La ricerca di bucket pubblici può aiutare a evitare la perdita di segreti. Oltre al tipo di accesso pubblico, questo scenario imposta i filtri per il nome del bucket, il nome del compartimento, il dominio di disponibilità, lo stato di controllo delle versioni e un valore statico.

Questo argomento descrive i task coinvolti nell'impostazione di questo scenario.

Questo scenario crea una metrica da un log utilizzando il servizio Hub connettore. L'impostazione di questo scenario comporta i task riportati di seguito.

• Creare un connettore per spostare i log da Log a una metrica personalizzata con dimensioni in Monitoraggio.

  • Dati di log: evento Bucket - aggiornamento da log di controllo (gruppo di log _Audit)

    Nota
    
    Sebbene questo scenario utilizzi il gruppo di log _Audit e l'evento di aggiornamento del bucket, è possibile utilizzare lo stesso approccio con qualsiasi log disponibile nella tenancy.

  • Spazio di nomi metrica: bucket_events

  • Nome metrica: update

  • Valore statico buckets-from-connector (nome dimensione: mytags)

  • Valore estratto utilizzando le dimensioni percorso:

    Nota
    
    

    Ogni nuovo valore di dimensione crea un nuovo flusso di metriche. Per evitare di generare troppi flussi di metriche univoci, che potrebbero potenzialmente causare limitazioni, si consiglia di escludere GUID o UUID (ad esempio gli OCID del compartimento) dalle dimensioni.

    Proprietà percorso (nome dimensione)	Valore
    bucketName	logContent.data.additionalDetails.bucketName
    compartmentName	logContent.data.compartmentName
    availabilityDomain	logContent.data.availabilityDomain
    publicAccessType	logContent.data.additionalDetails.publicAccessType
    versioning	logContent.data.additionalDetails.versioning

• Filtrare i dati spostati con le dimensioni (valori statici ed estratti).

Puoi completare questi task nella console, nell'interfaccia CLI o nell'API di Oracle Cloud Infrastructure.

Questo argomento descrive come utilizzare la console per impostare lo scenario.

Per assistenza nella risoluzione dei problemi, vedere Risoluzione dei problemi dei connettori e Risoluzione dei problemi delle notifiche.

In questo argomento viene descritto come utilizzare l'interfaccia CLI per creare il connettore e filtrare i dati spostati.

Per informazioni sull'uso dell'API e delle richieste di firma, consulta la documentazione dell'API REST e le credenziali di sicurezza. Per informazioni sugli SDK, vedere SDK e l'interfaccia CLI.

1. Definire l'origine log per il connettore: salvare un file denominato source.json.

   File source.json di esempio

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

2. Definire la destinazione (metrica e dimensioni) per il connettore: salvare un file denominato target.json.

   File target.json di esempio

   {
     "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. Creare un connettore: aprire un prompt dei comandi ed eseguire il comando oci sch service-connector create:

   Comando di esempio per la creazione di un connettore

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

4. Eseguire una query sui dati della metrica utilizzando le dimensioni personalizzate: aprire un prompt dei comandi ed eseguire il comando oci monitoring metric-data summarize-metrics-data:

   Comando di esempio per l'esecuzione di query sui dati delle metriche utilizzando dimensioni personalizzate

   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()

Per assistenza nella risoluzione dei problemi, vedere Risoluzione dei problemi dei connettori e Risoluzione dei problemi delle notifiche.

Questo argomento descrive come utilizzare l'interfaccia API per creare il connettore e filtrare i dati spostati.

Per informazioni sull'uso dell'API e delle richieste di firma, consulta la documentazione dell'API REST e le credenziali di sicurezza. Per informazioni sugli SDK, vedere SDK e l'interfaccia CLI.

Utilizzare le operazioni descritte di seguito.

1. CreateServiceConnector: crea un connettore.

   Esempio di richiesta 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: esegue una query sui dati della metrica in base alle dimensioni.

   Esempio di richiesta 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()"
   }

Per assistenza nella risoluzione dei problemi, vedere Risoluzione dei problemi dei connettori e Risoluzione dei problemi delle notifiche.