Szenario - Dimensionen für ein Monitoringziel erstellen

Wenn Sie Mitglied der Administratorengruppe sind, besitzen Sie bereits die erforderliche Berechtigung, um dieses Szenario durchzuführen. Andernfalls benötigen Sie Zugriff auf Monitoring .

Der Workflow zum Erstellen des Connectors umfasst eine Standard-Policy, die bei Bedarf Berechtigungen zum Schreiben in den Zielservice erteilen. Informationen zu Policys finden Sie unter Überblick über IAM-Policys.

In diesem Thema wird das Ziel dieses Szenarios beschrieben.

Ziel dieses Szenarios ist es, Aktualisierungsereignisse für Object Storage-Buckets zu filtern. Suchen Sie beispielsweise nach Aktualisierungen, durch die der Zugriff auf Buckets in öffentlichen Zugriff geändert wurde. Durch Ermitteln von öffentlichen Buckets können Sie verhindern, dass Geheimnisse nach außen dringen. Neben dem öffentlichen Zugriffstyp richtet dieses Szenario Filter für den Bucket-Namen, den Compartment-Namen, die Availability-Domain, den Versionsstatus und einen statischen Wert ein.

In diesem Thema werden die Aufgaben beschrieben, die beim Einrichten dieses Szenarios erforderlich sind.

In diesem Szenario wird mit dem Connector Hub-Service aus einem Log eine Metrik erstellt. Die Einrichtung dieses Szenarios umfasst die folgenden Aufgaben:

• Erstellen Sie einen Connector, um Logs aus Logging in eine benutzerdefinierte Metrik mit Dimensionen in Monitoring zu verschieben.

  • Logdaten: Ereignis Bucket - Aktualisieren aus Auditlogs (Loggruppe _Audit)

    Hinweis
    
    In diesem Szenario geht es zwar um die Loggruppe _Audit und das Bucket-Aktualisierungsereignis, aber Sie können den gleichen Ansatz für jedes in Ihrem Mandanten verfügbare Log verwenden.

  • Metrik-Namespace: bucket_events

  • Metrikname: update

  • Statischer Wert buckets-from-connector (Dimensionsname: mytags)

  • Extrahierter Wert mit Pfaddimensionen:

    Hinweis
    
    

    Jeder neue Dimensionswert erstellt einen neuen Metrikstream. Um zu viele eindeutige Metrikstreams zu generieren, die zu Throttling führen könnten, wird empfohlen, GUIDs oder UUIDs (wie Compartment-OCIDs) aus den Dimensionen auszuschließen.

    Pfadeigenschaft (Dimensionsname)	Wert
    bucketName	logContent.data.additionalDetails.bucketName
    compartmentName	logContent.data.compartmentName
    availabilityDomain	logContent.data.availabilityDomain
    publicAccessType	logContent.data.additionalDetails.publicAccessType
    versioning	logContent.data.additionalDetails.versionierung

• Filtern Sie die verschobenen Daten mit den Dimensionen (statische und extrahierte Werte).

Sie können diese Aufgaben in der Oracle Cloud Infrastructure-Konsole, in der CLI oder in der API ausführen.

In diesem Thema wird beschrieben, wie Sie das Szenario mit der Konsole einrichten.

Hilfe zur Fehlerbehebung finden Sie unter Fehlerbehebung bei Connectors und Fehlerbehebung bei Notifications.

In diesem Thema wird beschrieben, wie Sie mit der CLI den Connector erstellen und die verschobenen Daten filtern.

Informationen zur Verwendung der API und zu Signieranforderungen finden Sie unter REST-API-Dokumentation und Sicherheitszugangsdaten. Informationen zu SDKs finden Sie unter SDKs und die CLI.

1. Definieren Sie die Logquelle für den Connector: Speichern Sie eine Datei namens source.json.

   Beispiel für eine source.json-Datei

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

2. Definieren Sie das Ziel (Metrik und Dimensionen) für den Connector "Save a file namens target.json".

   Beispiel für eine target.json-Datei

   {
     "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. Erstellen Sie einen Connector: Öffnen Sie eine Befehlszeile, und führen Sie den Befehl oci sch service-connector create aus:

   Beispielbefehl zum Erstellen eines Connectors

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

4. Fragen Sie die Metrikdaten mit den benutzerdefinierten Dimensionen ab: Öffnen Sie eine Eingabeaufforderung, und führen Sie den Befehl oci monitoring metric-data summarize-metrics-data aus:

   Beispielbefehl zum Abfragen von Metrikdaten mit benutzerdefinierten Dimensionen

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

Hilfe zur Fehlerbehebung finden Sie unter Fehlerbehebung bei Connectors und Fehlerbehebung bei Notifications.

In diesem Thema wird beschrieben, wie Sie mit der API den Connector erstellen und die verschobenen Daten filtern.

Informationen zur Verwendung der API und zu Signieranforderungen finden Sie unter REST-API-Dokumentation und Sicherheitszugangsdaten. Informationen zu SDKs finden Sie unter SDKs und die CLI.

Verwenden Sie die folgenden Vorgänge:

1. CreateServiceConnector: Erstellen Sie einen Connector.

   Beispiel für eine CreateServiceConnector-Anforderung

   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: Metrikdaten nach Dimensionen abfragen.

   Beispiel für eine SummarizeMetricsData-Anforderung

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

Hilfe zur Fehlerbehebung finden Sie unter Fehlerbehebung bei Connectors und Fehlerbehebung bei Notifications.