Documentação do Oracle Cloud Infrastructure

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 Logging 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. Forneça permissão para acessar e coletar logs do serviço OCI Streaming. Consulte Permitir Coleta de Logs do OCI Streaming Service.

  2. Identifique ou crie o compartimento e o grupo de logs do Logging 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 de seus dados de streaming para identificar os campos. Consulte Criar um Parser.

    Observação

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

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

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

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

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

  5. Crie um novo conector de serviço para estabelecer uma conexão entre o OCI Streaming e o Oracle Logging Analytics para rotear seus logs personalizados. Especifique o destino como Logging Analytics 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 Documentação do OCI Service Connector Hub.

Depois que a conexão for estabelecida com o OCI Streaming, os logs personalizados começarão a fluir para o Oracle Logging Analytics.

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 ingiram no Oracle Logging Analytics.

As permissões a seguir são para fazer upload de logs para o Oracle Logging Analytics do 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 logs do Oracle Logging Analytics no qual os logs devem ser armazenados.

  • Log_Group_OCID: O OCID do grupo de logs no Oracle Logging 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 do stream no OCI Streaming.

  • Stream_OCID: O OCID do stream no OCI Streaming.

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