Ingestão de Logs Personalizados do Serviço Streaming do OCI Usando o Conector de Serviço

Se você quiser analisar e derivar insights de seus dados de streaming personalizados de alto volume no serviço OCI Streaming usando o Oracle Log Analytics, conclua as etapas a seguir para ingerir os logs de streaming.

Etapas para coletar logs personalizados do OCI Streaming usando o conector de serviço:

  1. Fornecer permissão para acessar e coletar logs do serviço OCI Streaming. Consulte Permitir Coleta de Logs do Serviço OCI Streaming.

  2. Identifique ou crie o compartimento e o grupo de logs do Log Analytics no qual os logs devem ser coletados.

  3. Crie um parser para fazer parsing de seus logs personalizados. Use o conteúdo de log de exemplo dos dados de streaming para identificar os campos. Consulte Criar um Parser.

    Observação

    O Log Analytics suporta parsers dos formatos Regex, XML e JSON. Certifique-se do seguinte:

    • Os dados de log em um fluxo devem ter um único formato, Regex, XML ou JSON e não ter vários formatos.

    • O parser identificado para um stream deve ter o mesmo formato que os dados de log nesse stream.

  4. Crie uma origem de log que melhor se adapte aos seus logs personalizados e inclua o parser que você criou na etapa anterior. Consulte Criar uma Origem.

    Como alternativa, você pode selecionar entre as origens de log disponíveis definidas pela Oracle. Consulte Origens Oracle-defined.

  5. Crie um novo conector de serviço para estabelecer uma conexão entre o OCI Streaming e o Oracle Log Analytics para rotear seus logs personalizados. Especifique Logging Analytics como destino e adicione uma nova origem correspondente aos Logs Personalizados do Streaming.

    Para obter etapas detalhadas para criar o conector de serviço usando a console, a API ou a CLI, consulte a Documentação do OCI Service Connector Hub.

Após a conexão ser estabelecida com o OCI Streaming, os logs personalizados começarão a fluir para o Oracle Log Analytics.

Para interromper a coleta de seus logs personalizados no OCI Streaming, siga etapas semelhantes a Interromper Coleta de Logs no Conector de Serviço. No entanto, o conector de serviço referenciado nas etapas deve ser aquele que você criou com o OCI Streaming como origem e o Oracle Log Analytics como destino dos logs.

Permitir Coleta de Logs do Serviço OCI Streaming

Crie políticas para permitir que os usuários coletem os logs do OCI Streaming e os ingeram no Oracle Log Analytics.

As permissões a seguir são para fazer upload de logs para o Oracle Log Analytics pelo conector de serviço. Você será solicitado a adicionar essas instruções de política ao criar o conector de serviço por meio da console do OCI. Como alternativa, você pode criar manualmente a política que inclui as seguintes instruções de política:

allow any-user to {LOG_ANALYTICS_LOG_GROUP_UPLOAD_LOGS} in compartment id <Log_Group_Compartment_OCID> where all {request.principal.type = 'serviceconnector', target.loganalytics-log-group.id = '<Log_Group_OCID>', request.principal.compartment.id = '<Service_Connector_Compartment_OCID>'}
allow group <userGroup> to MANAGE serviceconnectors in tenancy

Nas declarações de política acima,

  • Log_Group_Compartment_OCID: O OCID do compartimento do grupo de log no Oracle Log Analytics no qual os logs devem ser armazenados.

  • Log_Group_OCID: O OCID do grupo de log no Oracle Log Analytics no qual os logs devem ser armazenados.

  • Service_Connector_Compartment_OCID: O OCID do compartimento do hub do conector de serviço.

As permissões a seguir são para coletar logs do serviço OCI Streaming. Você será solicitado a adicionar essas instruções de política ao criar o conector de serviço por meio da console do OCI. Como alternativa, você pode criar manualmente a política que inclui as seguintes instruções de política:

allow any-user to {STREAM_READ, STREAM_CONSUME} in compartment id <Source_Stream_Compartment_OCID> where all {request.principal.type='serviceconnector', target.stream.id='<Stream_OCID>', request.principal.compartment.id='<Service_Connector_Compartment_OCID>'}

Nas declarações de política acima,

  • Source_Stream_Compartment_OCID: O OCID do compartimento dos dados de stream no OCI Streaming.

  • Stream_OCID: O OCID do stream no OCI Streaming.

  • Service_Connector_Compartment_OCID: O OCID do compartimento do conector do serviço.