Documentação do Oracle Cloud Infrastructure

Gerenciar Associação entre Entidade e Origem

Quando você usar Agentes de Gerenciamento para coletar logs continuamente, configure uma associação de entidade de origem para ativar uma origem de entidades específicas para coletar dados de log.

Tópicos:

Configurar Nova Associação entre Origem e Entidade

Configure novas associações entre origem e entidade para ativar a coleta contínua de logs após a instalação do Agente de Gerenciamento. Para configurar associações de entidades em grande escala, você pode usar as APIs de associação entre origem e entidade.

Para obter mais detalhes sobre as APIs de associação entre entidade e origem, consulte API do Logging Analytics.
  1. Abra o menu de navegação e clique em Observabilidade e Gerenciamento. Em Logging Analytics, clique em Administração. A página Visão Geral da Administração é aberta.

    Os recursos de administração são listados no painel de navegação à esquerda em Recursos. Clique em Origens.

    A página de listagem de origens mostrará todas as origens definidas pela Oracle e personalizadas. Você pode pesquisar e identificar um que deseja usar.

  2. Clique no nome da origem para o qual deseja criar a associação entre entidade e origem. A página de detalhes da origem é aberta. Localize a seção Recursos no lado esquerdo da página.

    Selecione o compartimento à esquerda da página de detalhes da Origem. Isso limitará as entidades visíveis para você com base no compartimento selecionado.

  3. Clique em Entidades Não Associadas para exibir as entidades elegíveis para associação com essa origem. As entidades listadas são aquelas do tipo de entidade especificado na definição da origem e estão disponíveis no compartimento selecionado.

    As entidades que não são elegíveis para associação com essa origem são listadas na seção Entidades Inelegíveis. Normalmente, os motivos da inelegibilidade são a ausência do Agente de Gerenciamento no host, não estar pronta para coleta de logs, validação do agente pendente ou problemas de política do agente. Depois que o Agente de Gerenciamento for instalado com sucesso no host da entidade e a entidade for configurada para usar o Agente de Gerenciamento, a entidade desaparecerá da lista Entidades Inelegíveis e aparecerá na lista Entidades Não Associadas.

  4. Selecione uma ou mais entidades não associadas para associar a essa origem e clique em Adicionar Associação.

    A caixa de diálogo Adicionar Associação é aberta.

  5. Selecione o compartimento que contém o grupo de logs no qual os dados de log devem estar localizados depois de serem coletados e indexados.
  6. Selecione o grupo de logs criado anteriormente durante a configuração.

    Para criar um novo grupo de logs, selecione o compartimento e clique em Criar Grupo de Logs. Na caixa de diálogo, digite o nome e a descrição. Clique em Criar.

  7. Clique em Submeter.

    A entidade selecionada agora é movida para a seção Entidades Associadas em que o status da associação é exibido. Se a tarefa de associação entre entidade e origem falhar, clique em Repetir Associação.

As instruções de coleta serão enviadas ao agente que está monitorando essa entidade conforme definido anteriormente e a coleta de logs será iniciada. Vá para a seção Advertências de Coleta do Agente para exibir as advertências da coleta de logs. Observe que a lista de advertências corresponde a todas as entidades de associação dessa origem.

Se você tiver problemas com o agente de gerenciamento que coleta logs, certifique-se de que os arquivos de log que são monitorados sejam legíveis para o usuário mgmt_agent como o qual o Agente de Gerenciamento é executado. Aguarde alguns minutos para exibir os logs no Log Explorer. Ao coletar logs dos arquivos do Sistema Operacional, os arquivos de log mais antigos são coletados primeiro. Portanto, você poderá ver os logs mais antigos carregados antes dos logs mais recentes. Depois que o agente tiver coletado os logs históricos, você começará a ver apenas os logs mais novos sendo coletados.

Ativar Associação Automática para uma Origem

Para ativar a coleta de logs de todas as entidades dos tipos de entidade especificados na definição de origem, ative a associação automática.

Usando as seguintes etapas para associar automaticamente a origem, você pode ativar a coleta de logs em todas as entidades elegíveis e atualmente não associadas e em todas as entidades futuras elegíveis que são criadas:

  1. Abra o menu de navegação e clique em Observabilidade e Gerenciamento. Em Logging Analytics, clique em Administração. A página Visão Geral da Administração é aberta.

  2. Os recursos de administração são listados no painel de navegação à esquerda em Recursos. Clique em Origens.

    A página de listagem de origens mostrará todas as origens definidas pela Oracle e personalizadas. Você pode pesquisar e identificar um que deseja usar.

  3. Clique no nome da origem cuja associação automática você deseja ativar. A página de detalhes da origem é aberta.

  4. Em Informações da Origem, clique em Ativar ao lado de Associação Automática.

    A caixa de diálogo Ativar Associação Automática é aberta.

  5. Selecione o compartimento que contém o grupo de logs no qual os dados de log devem estar localizados depois de serem coletados nas entidades e indexados.

  6. Selecione o grupo de logs no qual os dados de log devem ser armazenados.

    Para criar um novo grupo de logs, selecione o compartimento e clique em Criar Grupo de Logs. Na caixa de diálogo, digite o nome e a descrição. Clique em Criar.

  7. Clique em Ativar.

Observação

Depois que a associação automática for ativada, em um momento posterior, quando quaisquer novas entidades dos tipos de entidade especificados na definição da origem forem descobertas pelo Oracle Logging Analytics, elas serão associadas automaticamente à origem.

Interromper Coleta de Logs em uma Entidade

Quando uma origem e uma entidade são associadas, a coleta de logs é ativada nessa entidade. Os detalhes de indexação e pré-processamento de logs são especificados na definição da origem. Quando a coleta de logs nessa entidade precisar ser interrompida, desassocie a entidade da origem.

  1. Abra o menu de navegação e clique em Observabilidade e Gerenciamento. Em Logging Analytics, clique em Administração. A página Visão Geral da Administração é aberta.

  2. Os recursos de administração são listados no painel de navegação à esquerda em Recursos. Clique em Origens.

    A página de listagem de origens mostrará todas as origens definidas pela Oracle e personalizadas. Você pode pesquisar e identificar um que deseja usar.

  3. Clique no nome da origem. A página de detalhes da origem é aberta. A seção Entidades Associadas exibe a lista de entidades associadas a essa origem e de onde os logs são coletados no momento.

  4. Selecione a entidade cuja coleta de logs você deseja interromper. Clique em Remover entidades.

    Para interromper a coleta de logs dessa origem, use o recurso de várias seleções para selecionar todas as entidades.

    Se preferir, caso você tenha ativado a associação automática da origem e queira interromper a coleta em todas as entidades associadas, poderá desativar a associação automática e remover as associações de entidades existentes. Consulte Desativar Associação Automática para uma Origem.

A associação com a entidade selecionada agora é removida, a coleta de logs é interrompida nela e a entidade agora é movida para a seção Entidades Não Associadas.

Desativar Associação Automática para uma Origem

Ao ativar a associação automática, você associou automaticamente à origem todas as entidades elegíveis dos tipos de entidade especificados na definição da origem. Para desativar a associação automática e ser seletivo com a associação entre entidade e origem, siga estas etapas:

  1. Abra o menu de navegação e clique em Observabilidade e Gerenciamento. Em Logging Analytics, clique em Administração. A página Visão Geral da Administração é aberta.

  2. Os recursos de administração são listados no painel de navegação à esquerda em Recursos. Clique em Origens.

    A página de listagem de origens mostrará todas as origens definidas pela Oracle e personalizadas. Você pode pesquisar e identificar um que deseja usar.

  3. Clique no nome da origem cuja associação automática você deseja desativar. A página de detalhes da origem é aberta.

  4. Em Informações da Origem, clique em Desativar ao lado de Associação Automática.

    A caixa de diálogo Desativar Associação Automática é aberta.

  5. Clique em Desativar para o recurso de associação automática da origem. Com isso, nenhuma nova entidade elegível será associada automaticamente à origem. No entanto, a coleta de logs continuará para as entidades anteriormente associadas por meio do recurso de associação automática.

    Você poderá interromper a coleta de logs em todas as entidades associadas anteriormente, removendo sua associação com a origem. Para isso, ative a caixa de seleção Remover todas as associações de entidades existentes na caixa de diálogo Desativar Associação Automática antes de confirmar.