Processar Logs de Outros Serviços do OCI Usando o Conector de Serviço

Com base no tipo de logs de serviço que deseja ingerir, crie políticas para permitir que Oracle Log Analytics obtenha as informações sobre os recursos e crie uma entidade para cada recurso.

Depois que você criar a política, a entidade criada será associada automaticamente a todos os logs coletados desse recurso. Se a política não for criada, os logs ainda serão ingeridos, mas a entidade não será criada.

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
allow group <userGroup> to READ logging-family 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.

O Oracle Log Analytics cria uma entidade que representa o recurso subjacente do OCI quando novos logs são recebidos por meio do conector de serviço. Para obter as informações necessárias do recurso do OCI, você deve fornecer ao Oracle Log Analytics um acesso mínimo de read ao recurso do OCI. Por exemplo, para ler informações sobre um bucket no serviço Object Storage, você pode gravar uma das seguintes políticas:

Instrução de política com o READ PRIVILEGE do recurso do OCI:

allow resource loganalyticsvrp LogAnalyticsVirtualResource to {BUCKET_READ} in compartment <specify_compartment>

OU

Instrução de política com o verbo read para a RECURSO do OCI:

allow resource loganalyticsvrp LogAnalyticsVirtualResource to read buckets in compartment <specify_compartment>

As instruções de política acima restringem o acesso read a um compartimento. Para estender o acesso a toda a tenancy, você pode alterar a instrução de política adequadamente.

Os recursos do OCI a seguir são suportados no Oracle Log Analytics para coleta de logs por meio do conector de serviço. Você pode criar a política usando o verbo de leitura para o recurso do OCI ou usar o privilégio de leitura para o recurso, conforme ilustrado acima.

Antes de configurar o conector de serviço para ingerir logs, certifique-se de que o compartimento e o grupo de logs sejam identificados para os logs que você deseja ingerir.

No exemplo a seguir, as etapas mostram como coletar logs de serviço de VCN no serviço de Registro em Log do Oracle Cloud Infrastructure:

1. Esta é uma etapa sugestiva para mostrar como ativar logs no serviço de Registro em Log do Oracle Cloud Infrastructure.

   Vá para o serviço Oracle Cloud Infrastructure Logging e vá para Logs.

   Clique em Ativar Log de Recursos para ativar logs de serviço da VCN. A caixa de diálogo é aberta.

   1. Selecione o compartimento de recursos.
   2. Selecione o serviço, por exemplo, Virtual Cloud Network (subnets).
   3. Selecione o recurso, por exemplo, da VCN.
   4. Em Configurar Log, selecione a categoria de log, por exemplo, Flow Logs e o nome do log.
   5. Em Local do Log, selecione o compartimento e grupo de logs dos quais o Oracle Log Analytics fará referência aos logs.

   Clique em Ativar Log.

2. Configure o conector do serviço especificando o serviço de origem dos logs e o destino como Oracle Log Analytics. Você pode configurá-lo no serviço de origem que foi integrado ao Oracle Cloud Infrastructure Service Connector Hub, por exemplo, no serviço de Registro em Log do Oracle Cloud Infrastructure ou diretamente do Oracle Cloud Infrastructure Service Connector Hub.

   Vá para o serviço Oracle Cloud Infrastructure Logging, vá para Connectores de Serviço e clique em Criar Conector.

   Como alternativa, vá para o serviço Oracle Cloud Infrastructure Service Connector Hub e clique em Criar Conector de Serviço.

   A página Criar Conector de Serviço é aberta.

   1. Digite um nome para o conector e forneça uma descrição.
   2. Selecione o compartimento de recursos no qual o recurso do conector deve ser criado.
   3. Em Configurar Conector de Serviço, especifique Logging como o serviço de Origem e Logging Analytics como o serviço de Destino.
   4. Em Configurar Conexão de Origem, forneça os detalhes dos logs a serem coletados do serviço, por exemplo, os logs de serviço da VCN.

      Selecione o nome do compartimento, o grupo ao qual os logs pertencem e o nome dos logs que você configurou na etapa 1.

   Você pode configurar o mesmo conector de serviço para coletar mais logs. Clique em Outro Log e repita a etapa 2-d.

   Se desejar, você poderá criar filtros em Configurar Tarefa.

   Clique em Criar Conector.

Depois que o conector de serviço for criado, você poderá verificar se os logs selecionados estão disponíveis no Oracle Log Analytics.

Deixe Source_Tenant ser o tenant do serviço de origem, como o Registro em Log do Oracle Cloud Infrastructure do qual os logs são coletados. Deixe que Target_Tenant seja o tenant no qual o conector de serviço é criado. O conector de serviço é configurado com o Oracle Log Analytics como o destino dos logs coletados do serviço de origem. Supõe-se que o hub de conector de serviço e o Oracle Log Analytics estejam disponíveis no mesmo tenant de destino.

Defina as políticas a seguir para configurar a coleta de log de uma tenancy que seja diferente da tenancy em que o conector é criado.

define tenancy <Target_Tenant> as <Target_Tenant_OCID>
define group <Common_User_Group> as <Common_User_Group_OCID>
admit any-user of tenancy <Target_Tenant> to read logging-family IN TENANCY WHERE ALL {request.principal.type = 'serviceconnector'}
admit group <Common_User_Group> of tenancy <Target_Tenant> to read logging-family IN TENANCY

admit group <Common_User_Group> of tenancy <Target_Tenant> to read audit-events in TENANCY
admit any-user of tenancy <Target_Tenant> to read audit-events IN tenancy WHERE ALL {request.principal.type = 'serviceconnector'}

define tenancy <Source_Tenant> as <Source_Tenant_OCID>
endorse any-user to read logging-family IN tenancy <Source_Tenant> WHERE ALL {request.principal.type = 'serviceconnector'}
endorse group <Common_User_Group> to read logging-family IN tenancy <Source_Tenant>

endorse group <Common_User_Group> to read audit-events in tenancy <Source_Tenant>
endorse any-user to read audit-events in tenancy <Source_Tenant> WHERE ALL {request.principal.type = 'serviceconnector'}

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 <Common_User_Group> to MANAGE serviceconnectors in tenancy

oci --profile <Target_Profile> sch service-connector create 
    --display-name XTenancyConnector 
    --compartment-id <Connector_Compartment_OCID> 
    --source '{ "kind": "logging", "logSources": 
        [ { "compartmentId": "<Logging_LogGroup_Compartment_OCID>", 
            "logGroupId": "<Logging_LogGroup_OCID>" } ] }' 
    --target '{ "kind": "loggingAnalytics", "logGroupId": "<LogAnalytics_LogGroup_OCID>" }'

Se você tiver configurado um Conector de Serviço para coletar continuamente logs do OCI Logging para o Oracle Log Analytics, poderá interromper a coleta de logs desativando o conector ou excluindo-o.

Se sua necessidade for interromper temporariamente a coleta de logs, mas manter a configuração do conector de forma que você possa reiniciar a coleta de logs posteriormente, Desative o conector.

Se você quiser interromper permanentemente a coleta de logs do conector de serviço, Exclua o conector.

1. Identificar o Conector de Serviço configurado para coleta de logs: Navegue até o serviço Connector Hub e liste os conectores no seu compartimento. Consulte Listando Conectores.

   Clique no nome do conector para exibir os detalhes e a configuração do conector. Identifique o conector de serviço correto que está configurado para sua coleta de logs.

2. Interromper coleta de logs: Dependendo da sua necessidade, clique em Desativar ou Excluir. Consulte Desativando um Conector e Excluindo um Conector.

   Isso interrompe o fluxo de dados do serviço OCI específico para o Oracle Log Analytics.

Se você tiver desativado o conector e quiser reiniciar a coleta de logs, reative esse conector. Consulte Ativando um Conector.