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:
-
Fornecer permissão para acessar e coletar logs do serviço OCI Streaming. Consulte Permitir Coleta de Logs do Serviço OCI Streaming.
-
Identifique ou crie o compartimento e o grupo de logs do Log Analytics no qual os logs devem ser coletados.
-
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.
-
-
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.
-
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 Analyticscomo 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 tenancyNas 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.