Cenário: Enviando Métricas ao Serviço Object Storage

Saiba como enviar métricas para um bucket no Object Storage usando o Connector Hub.

Política Obrigatória do Serviço IAM

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 de leitura às métricas nos compartimentos especificados.

O workflow para criar um conector com uma origem de Monitoramento inclui uma política padrão para leitura do Monitoring nos compartimentos selecionados. Se você não estiver familiarizado com políticas, consulte Visão Geral de Políticas do Serviço IAM.

Meta

O objetivo desse cenário é arquivar dados de métricas para instâncias de computação e volumes em blocos em um bucket do Object Storage. Neste cenário, os recursos estão em dois compartimentos; portanto, você selecionará métricas em ambos os compartimentos.

Configurando este Cenário

A configuração desse cenário envolve a criação de um conector para mover métricas de instância de computação e volume em blocos (oci_computeagent e namespaces de métrica oci_blockstore) para um bucket. Todas as métricas desses namespaces estão incluídas.

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

    1. Na página da lista Conectores, selecione Criar conector. Se precisar de ajuda para localizar a página da lista, consulte Listando Conectores.
    2. Na página Criar conector, digite um nome amigável para o novo conector e uma descrição opcional. Evite digitar informações confidenciais.
      Exemplo: "Métricas para o Bucket"
    3. Para Compartimento de recursos, selecione o compartimento no qual você deseja armazenar o novo conector.
    4. Em Configurar conector, selecione seus serviços de origem e destino para mover dados de log para uma métrica:
      • Origem: Monitoramento
      • Destino: Object Storage
    5. Em Configurar origem, selecione a instância de computação e as métricas de volume em blocos em cada compartimento:
      1. Compartimento de métricas: O primeiro compartimento que contém as instâncias de computação e os volumes em blocos para os quais você deseja métricas.

      2. Namespaces: Selecione oci_computeagent e oci_blockstore.

      3. Selecione + Outro compartimento para adicionar o segundo compartimento.

      4. Compartimento de métricas: O segundo compartimento que contém as instâncias de computação e os volumes em blocos para os quais você deseja métricas.

      5. Namespaces: Selecione oci_computeagent e oci_blockstore.

    6. Ignore a tarefa opcional (Configurar tarefa).
    7. Em Configurar destino, selecione o bucket para o qual você deseja mover as métricas:
      • Selecione o Compartimento que contém o bucket.
      • Selecione o Bucket que você quer.
    8. Aceitar políticas padrão: Selecione o link Criar fornecido para cada política padrão.
    9. Selecione Criar.

    O processo de criação é iniciado e seu progresso é exibido. Na conclusão, a página de detalhes do conector é aberta. O novo conector começa imediatamente a mover métricas para o bucket selecionado. As métricas estão contidas em objetos dentro do bucket.

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

      Exemplo de arquivo source.json
      {
        "kind": "monitoring",
        "monitoringSources": [
          {
            "compartmentId": "<first_compartment_OCID>",
            "namespaceDetails": {
              "kind": "selected",
              "namespaces": [
                {
                  "namespace": "oci_computeagent",
                  "metrics": {
                    "kind": "all"
                  }
                },
                {
                  "namespace": "oci_blockstore",
                  "metrics": {
                    "kind": "all"
                  }
                }
              ]
            }
          },
          {
            "compartmentId": "<second_compartment_OCID>",
            "namespaceDetails": {
              "kind": "selected",
              "namespaces": [
                {
                  "namespace": "oci_computeagent",
                  "metrics": {
                    "kind": "all"
                  }
                },
                {
                  "namespace": "oci_blockstore",
                  "metrics": {
                    "kind": "all"
                  }
                }
              ]
            }
          }
        ]
      }
    2. Defina o destino do Object Storage para o conector: Salve um arquivo chamado target.json.

      Exemplo de arquivo target.json
      {
        "kind": "objectStorage",
        "bucketName": "<bucket_name>",
        "objectNamePrefix": "<prefix>"
      }
    3. Crie o conector usando 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 "Metrics to Bucket"
       --source file://source.json
       --target file://target.json

      Para obter uma lista completa dos parâmetros e valores dos comandos da CLI, consulte a Referência de Comandos da CLI.

      Para obter ajuda para diagnosticar e solucionar problemas, consulte Solucionando Problemas dos Conectores e Solucionando Problemas das Notificações.

    Para obter uma lista completa de flags e opções de variáveis para comandos da CLI, consulte a Referência de Linha de Comando.

  • Use a operação CreateServiceConnector para criar o 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": "Metrics to Bucket",
      "source": {
        "kind": "monitoring",
        "monitoringSources": [
          {
            "compartmentId": "<first_compartment_OCID>",
            "namespaceDetails": {
              "kind": "selected",
              "namespaces": [
                {
                  "namespace": "oci_computeagent",
                  "metrics": {
                    "kind": "all"
                  }
                },
                {
                  "namespace": "oci_blockstore",
                  "metrics": {
                    "kind": "all"
                  }
                }
              ]
            }
          },
          {
            "compartmentId": "<second_compartment_OCID>",
            "namespaceDetails": {
              "kind": "selected",
              "namespaces": [
                {
                  "namespace": "oci_computeagent",
                  "metrics": {
                    "kind": "all"
                  }
                },
                {
                  "namespace": "oci_blockstore",
                  "metrics": {
                    "kind": "all"
                  }
                }
              ]
            }
          }
        ]
      },
      "target": {
        "kind": "objectStorage",
        "bucketName": "<bucket_name>",
        "objectNamePrefix": "<prefix>"
      }
    }

O Que Fazer Em Seguida

Para exibir objetos na Console, selecione o nome do bucket mostrado na página de detalhes do conector. (Pode ser necessário rolar para ver o nome do bucket.)

Para obter informações sobre o download de objetos, consulte Fazendo Download de um Objeto de Armazenamento de Objetos.

Se não houver métricas no bucket, consulte as informações de diagnóstico e solução de problemas em Nenhum Dado Está Sendo Movido. Para obter ajuda geral com a solução de problemas, consulte Diagnosticando e Solucionando Problemas de Conectores.