Cenário: Enviando Dados de Streaming ao Log Analytics

Saiba como enviar dados de streaming do serviço OCI Streaming para o Log Analytics usando o Connector Hub. O streaming ingere e consome fluxos de dados de alto volume em tempo real.

Política Obrigatória do Serviço IAM

As políticas padrão fornecem o acesso necessário. O workflow para criar um conector com uma origem do serviço Streaming e um destino do Log Analytics inclui uma política padrão para ler streams e uma política padrão para gravar no Log Analytics. Se você não estiver familiarizado com políticas, consulte Visão Geral de Políticas do Serviço IAM.

Configurando este Cenário

A configuração desse cenário envolve a criação de um conector para mover streams para o Log Analytics para análise.

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

Usando a Console

Abra o menu de navegação e selecione Análise e IA. Em Mensagens, selecione Connector Hub.
Escolha o Compartimento no qual você deseja criar o conector.
Selecione Criar conector.
Na página Criar conector, mova streams para o Log Analytics:
1. Digite um Nome do conector. Evite digitar informações confidenciais. Exemplo: "Métricas para o Bucket"
2. Selecione o Compartimento de recursos no qual você deseja armazenar o novo conector.
3. Em Configurar conector, selecione seus serviços de origem e destino para mover dados de log para uma métrica:
  - Origem: Streaming
  - Destino: Logging Analytics
4. Em Configurar origem, selecione o fluxo:
  - Compartimento: Selecione o compartimento que contém o stream.
  - Pool de streams: Selecione o nome do pool de streams que contém o stream.
  - Stream: Selecione o nome do stream do qual você deseja receber dados.
  - Ler posição: Selecione Mais Recente para começar a ler nas mensagens publicadas depois de salvar o conector.
5. Ignore a tarefa opcional (Configurar tarefa).
6. Em Configurar destino, selecione o grupo de logs e a origem para o qual você deseja mover o fluxo para:
  - Compartimento: Selecione o compartimento que contém o grupo de logs.
  - Grupo de logs: Selecione o grupo de logs desejado.
  - Identificador de origem do log: Selecione a origem do log que você deseja.
Se for solicitado que você crie uma política (obrigatória para que o conector acesse serviços de origem, tarefa e destino), selecione Criar.
Selecione Criar.

O novo conector começa imediatamente a mover o fluxo para o grupo de logs e a origem selecionados.

Usando a CLI

Defina a origem do Streaming para o conector: salve um arquivo chamado source.json.
Exemplo de arquivo source.json
```
{
  "kind": "streaming",
  "streamId": "<stream_OCID>",
  "cursor" : {
      "kind": "LATEST"
  }
}
```
Defina o destino do Object Storage para o conector: Salve um arquivo chamado target.json.
Exemplo de arquivo target.json
```
{
 "kind": "loggingAnalytics",
 "logGroupId": "<log_group_OCID>",
 "logSourceIdentifier": "<log_source_name>"
}
```
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 "Stream to Log Analytics" --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.

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

Usando a API

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": "Stream to Log Analytics",
  "source": {
    "kind": "streaming",
    "streamId": "<stream_OCID>",
    "cursor" : {
        "kind": "LATEST"
    }
  },
  "target": {
   "kind": "loggingAnalytics",
   "logGroupId": "<log_group_OCID>",
   "logSourceIdentifier": "<log_source_name>"
  }
}