Cenário: Criando Dimensões para um Destino do Serviço Monitoring

Se você for membro do grupo Administradores, já terá o acesso necessário para concluir esse cenário. Caso contrário, você precisará de acesso ao serviço Monitoring.

O workflow para criar o conector inclui uma política padrão quando necessário para fornecer permissão para gravar no serviço de destino. Se você não estiver familiarizado com políticas, consulte Visão Geral de Políticas do Serviço IAM.

Este tópico descreve a meta deste cenário.

A meta deste cenário é filtrar eventos da atualização para buckets do serviço Object Storage. Por exemplo, localize atualizações que alteraram buckets para acesso público. A localização de buckets públicos pode ajudar a evitar vazamento de segredos. Além do tipo de acesso público, esse cenário configura filtros para nome do bucket, nome do compartimento, domínio de disponibilidade, status do controle de versão e um valor estático.

Este tópico descreve as tarefas envolvidas na configuração deste cenário.

Este cenário cria uma métrica de um log usando o Connector Hub. A configuração desse cenário envolve as tarefas a seguir:

• Crie um conector para mover logs do serviço Logging para uma métrica personalizada com dimensões no Monitoring.

  • Dados de log: evento Bucket - Atualizar de Logs de auditoria (grupo do log _Audit)

    Observação
    
    Embora esse cenário use o grupo de logs _Audit e o evento de atualização do bucket, você pode usar a mesma abordagem com qualquer log disponível na sua tenancy.

  • Namespace da métrica: bucket_events

  • Nome da métrica: update

  • Valor estático buckets-from-connector (nome da dimensão: mytags)

  • Valor extraído usando as dimensões de caminho:

    Observação
    
    

    Cada novo valor de dimensão cria um novo fluxo de métrica. Para evitar a geração de muitos fluxos de métricas exclusivos, que podem resultar em limitação, é recomendável excluir GUIDs ou UUIDs (como OCIDs de compartimento) das dimensões.

    Propriedade do caminho (nome da dimensão)	Valor
    bucketName	logContent.data.additionalDetails.bucketName
    compartmentName	logContent.data.compartmentName
    availabilityDomain	logContent.data.availabilityDomain
    publicAccessType	logContent.data.additionalDetails.publicAccessType
    versioning	logContent.data.additionalDetails.versioning

• Filtre os dados movidos com as dimensões (valores estáticos e extraídos).

Você pode concluir essas tarefas na Console, na CLI ou na API do Oracle Cloud Infrastructure.

Este tópico descreve como usar a Console para configurar o cenário.

Para obter ajuda para solucionar problemas, consulte Diagnóstico e Solução de Problemas com Conectores e Diagnóstico e Solução de Problemas com Notificações.

Este tópico descreve como usar a CLI para criar o conector e filtrar os dados movidos.

Para obter informações sobre como usar a API e assinar solicitações, consulte a documentação da API REST e Credenciais de Segurança. Para obter informações sobre SDKs, consulte SDKs e a CLI.

1. Defina a origem do log para o conector: salve um arquivo chamado source.json.

   Exemplo de arquivo source.json

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

2. Defina o destino (métrica e dimensões) para o conector: salve um arquivo chamado target.json.

   Exemplo de arquivo 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. Crie um conector: Abra um prompt de comando e execute o comando oci sch service-connector create:

   Exemplo de comando para criar um conector

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

4. Consulte os dados de métrica usando as dimensões personalizadas: Abra um prompt de comando e execute o comando oci monitoring metric-data summarize-metrics-data:

   Exemplo de comando para consultar dados de métrica usando dimensões personalizadas

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

Para obter ajuda para solucionar problemas, consulte Diagnóstico e Solução de Problemas com Conectores e Diagnóstico e Solução de Problemas com Notificações.

Este tópico descreve como usar a API para criar o conector e filtrar os dados movidos.

Para obter informações sobre como usar a API e assinar solicitações, consulte a documentação da API REST e Credenciais de Segurança. Para obter informações sobre SDKs, consulte SDKs e a CLI.

Use as seguintes operações:

1. CreateServiceConnector: Cria um conector.

   Exemplo de solicitação 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: consulte os dados de métrica por dimensões.

   Exemplo de solicitação 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()"
   }

Para obter ajuda para solucionar problemas, consulte Diagnóstico e Solução de Problemas com Conectores e Diagnóstico e Solução de Problemas com Notificações.