Criando um Conector com uma Origem de Monitoramento

[
  {
    "namespace":"oci_computeagent",
    "compartmentId":"ocid1.tenancy.oc1..exampleuniqueID",
    "name":"DiskBytesRead",
    "dimensions":{
      "resourceId":"ocid1.instance.region1.phx.exampleuniqueID"
    },
    "metadata":{
      "unit":"bytes"
    }
  },
  "datapoints":[
    {
      "timestamp":"2022-03-10T22:19:00Z",
      "value":10.4
    },
    {
      "timestamp":"2022-03-10T22:20:00Z",
      "value":11.3
    }
  ]
]

• Console
• CLI
• API

• 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.
  3. Selecione o compartimento no qual você deseja armazenar o novo conector.
  4. Em Configurar conector, para Origem, selecione Monitoramento.
  5. Para Alvo, selecione o serviço para o qual você deseja transferir os pontos de dados de métrica:
     • Functions: Envie pontos de dados de métrica para uma função.
     • Object Storage: Envie pontos de dados de métrica para um bucket.
     • Streaming: Envie pontos de dados de métrica para um stream.
  6. (Opcional) Para ativar logs de serviço para o novo conector, selecione a chave Logs e forneça os seguintes valores:
     • Categoria de log: O valor Rastreamento de Conector é selecionado automaticamente.
     • Compartimento: Selecione o compartimento que você deseja armazenar os logs de serviço do conector.
     • Grupo de logs: Selecione o grupo de logs que você deseja armazenar os logs de serviço. Para criar um novo grupo de logs, selecione Criar novo grupo e informe um nome.
     • Nome do log: Opcionalmente, digite um nome para o log.
     • Mostrar opções avançadas:
       • Retenção de log: Como opção, especifique por quanto tempo manter os logs de serviço (padrão: 30 dias).
  7. Em Configurar conexão de origem, selecione a métrica de origem:
     • Compartimento de métricas: Selecione o compartimento que contém as métricas desejadas.
     • Namespaces: Selecione um ou mais namespaces de métricas que incluam as métricas desejadas. Todas as métricas nos namespaces selecionados são recuperadas.

       Os namespaces devem começar com "oci_". Exemplo: oci_computeagent.

     • Para adicionar namespaces de métricas de outro compartimento, selecione + Outro compartimento.

       O número máximo de compartimentos de métrica por origem de Monitoramento é 5. O número máximo de namespaces por origem do serviço Monitoring (em todos os compartimentos de métricas) é 50. Veja a seguir exemplos de conjuntos de compartimentos em uma única origem que permanecem dentro desse máximo:

       • 5 compartimentos de métrica com 10 namespaces cada
       • 3 compartimentos de métrica com números variados de namespaces (20, 20, 10)
       • 1 compartimento de métrica com 50 namespaces
  8. (Opcional) Em Configurar tarefa de função, configure uma tarefa de função para processar pontos de dados de métrica usando o serviço Functions):
     • Selecionar tarefa: Selecione Função.
     • Compartimento: Selecione o compartimento que contém a função desejada.
     • Aplicativo de função: Selecione o nome do aplicativo de função que inclui a função desejada.
     • Função: Selecione o nome da função que você deseja usar para processar os dados recebidos da origem.

       Para uso pelo conector como uma tarefa, a função deve ser configurada para retornar uma das seguintes respostas:

       • Lista de entradas JSON (deve definir o cabeçalho de resposta Content-Type=application/json)
       • Entrada JSON única (deve definir o cabeçalho de resposta Content-Type=application/json)
       • Objeto binário único (deve definir o cabeçalho de resposta Content-Type=application/octet-stream)
     • Mostrar opções adicionais: Selecione este link e especifique limites para cada batch de dados enviado à função. Para usar configurações manuais, forneça valores para limite de tamanho do lote (KBs) e limite de tempo do lote (segundos).

     Considerações para tarefas de função:

     • O Connector Hub não faz parsing da saída da tarefa de função. A saída da tarefa de função é gravada como está no destino. Por exemplo, ao usar um destino do serviço Notifications com uma tarefa de função, todas as mensagens são enviadas como blobs de JSON brutos.
     • As funções são chamadas de forma síncrona com 6 MB de dados por chamada. Se os dados excederem 6 MB, o conector chamará a função novamente para mover os dados que estão acima do limite. Essas chamadas são tratadas sequencialmente.
     • As funções podem ser executadas por até cinco minutos. Consulte Detalhes da Entrega.
     • As tarefas de função são limitadas a funções escalares.
  9. Se você tiver selecionado Funções como destino, em Configurar destino, configure a função para a qual enviar os pontos de dados da métrica. Em seguida, vá para a etapa 13.
     • Compartimento: Selecione o compartimento que contém a função desejada.
     • Aplicativo de função: Selecione o nome do aplicativo de função que contém a função desejada.
     • Função: Selecione o nome da função para a qual você deseja enviar os dados.
     • Mostrar opções adicionais: Selecione este link e especifique limites para cada batch de dados enviado à função. Para usar definições manuais, forneça valores para limite de tamanho do lote (KBs ou número de mensagens) e limite de tempo do lote (segundos).

       Por exemplo, limite o tamanho do lote selecionando 5.000 kilobytes ou 10 mensagens. Um exemplo de limite de tempo do batch é de 5 segundos.

     Considerações para destinos de Funções:

     • O conector descarrega dados de origem como uma lista JSON em lotes. Lote máximo, ou carga útil, o tamanho é de 6 MB.
     • As funções são chamadas de forma síncrona com 6 MB de dados por chamada. Se os dados excederem 6 MB, o conector chamará a função novamente para mover os dados que estão acima do limite. Essas chamadas são tratadas sequencialmente.
     • As funções podem ser executadas por até cinco minutos. Consulte Detalhes da Entrega.
     • Não retorne dados dos destinos do serviço Functions para conectores. O Connector Hub não lê os dados retornados dos destinos do serviço Functions.
  10. Se você tiver selecionado o serviço Object Storage como destino, em Configurar destino, configure o bucket para o qual enviar os pontos de dados de métrica. Em seguida, vá para a etapa 13.
      • Compartimento: Selecione o compartimento que contém o bucket desejado.
      • Bucket: Selecione o nome do bucket para o qual você deseja enviar os dados.
      • Prefixo do Nome do Objeto: Opcionalmente, informe um valor de prefixo.
      • Mostrar opções adicionais: Selecione este link e, opcionalmente, informe valores para o tamanho do batch (em MBs) e o tempo do batch (em milissegundos).

      Considerações para destinos de Armazenamento de Objetos:

      • Detalhes da substituição do batch:

        • Tamanho da substituição do batch: 100 MB
        • Tempo de substituição do batch: 7 minutos

      • Os arquivos salvos no serviço Object Storage são compactados usando gzip.

      • Formato de dados movidos de uma origem de Monitoramento: Objetos. O conector particiona dados de origem do Monitoring por namespace de métricas e grava os dados de cada grupo (namespace) em um objeto. Cada nome de objeto inclui os elementos a seguir.

        <object_name_prefix>/<service_connector_ocid>/<metric_compartment_ocid>/<metric_namespace>/<data_start_timestamp>_<data_end_timestamp>.<sequence_number>.<file_type>.gz

        Em um objeto, cada conjunto de pontos de dados é anexado a uma nova linha.

  11. Se você selecionou Streaming como destino, em Configurar destino, configure o fluxo para o qual enviar os pontos de dados de métrica.
      Observação
      
      Para selecionar um pool de streams e um stream para um conector, você deve ter autorização para ler o pool de streams e o stream. Consulte Políticas do IAM (Protegendo o Connector Hub). Configuração de ponto final privado é suportada. Para usar um ponto final privado, consulte Pré-requisitos de Ponto Final Privado para Streams.

      • Compartimento: Selecione o compartimento que contém o fluxo desejado.
      • Stream: Selecione o nome do stream para o qual você deseja enviar os dados.

      Considerações para destinos de Streaming:

      • Formato dos dados movidos de uma origem de Monitoramento: Cada objeto é gravado como uma mensagem separada.
  12. Para aceitar políticas padrão, selecione o link Criar fornecido para cada política padrão.

      As políticas padrão são oferecidas para qualquer autorização necessária para que este conector acesse os serviços de origem, tarefa e destino.

      Você pode obter essa autorização por meio dessas políticas padrão ou de políticas baseadas em grupo. As políticas padrão são oferecidas sempre que você usa a Console para criar ou editar um conector. A única exceção é quando a política exata já existe no serviço IAM; nesse caso, a política padrão não é oferecida. Para obter mais informações sobre esse requisito de autorização, consulte Autenticação e Autorização.

      • Se você não tiver permissões para aceitar políticas padrão, entre em contato com o administrador.
      • As políticas criadas automaticamente permanecem quando os conectores são excluídos. Como prática recomendada, exclua as políticas associadas ao excluir o conector.

      Para revisar uma política recém-criada, selecione o link de exibição associado.

  13. (Opcional) Adicione uma ou mais tags ao conector: Selecione Mostrar Opções Avançadas para mostrar a seção Adicionar Tags.
      Se você tiver permissões para criar um recurso, também terá permissões para aplicar tags de formato livre a esse recurso. Para aplicar uma tag definida, você deverá ter permissões para usar o namespace da tag. Para obter mais informações sobre tags, consulte Tags de Recurso. Se você não tiver certeza se deseja aplicar tags, ignore esta opção ou pergunte a um administrador. Você pode aplicar tags posteriormente.
  14. Selecione Criar.

  O processo de criação é iniciado e seu progresso é exibido. Na conclusão, a página de detalhes do conector é aberta.

• Use o comando oci sch service-connector create e os parâmetros necessários para criar um conector com uma origem de Monitoramento:

  oci sch service-connector create --display-name "<display_name>" --compartment-id <compartment_OCID> --source [<metrics_source_in_JSON>] --target [<target_in_JSON>]

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

• Execute a operação CreateServiceConnector para criar um conector.

  Para criar um conector com uma origem de Monitoramento, preencha source na solicitação (CreateServiceConnectorDetails) com detalhes de monitoramento. Para obter um exemplo, consulte MonitoringSourceDetails.