Entidade é um recurso do Logging Analytics que é usado para fazer referência ao ativo real no host local ou virtual. Depois de descobrir essa entidade no Logging Analytics, você poderá associá-la a uma origem de log e ativar a coleta de log nela.

Recursos Úteis:

• Para saber mais sobre uma entidade, consulte Termos e Conceitos do Logging Analytics.

• Para criar uma entidade, consulte Criar uma Entidade para Representar Seu Recurso de Emissão de Log. Além disso, o Logging Analytics permite que você edite-o posteriormente, mova-o de um compartimento para outro e execute várias outras tarefas de gerenciamento conforme listadas a seguir.

• Para iniciar a descoberta de entidades como aplicativos em pacote, bancos de dados, middleware e outros componentes, consulte Descoberta Automática de Entidades e Coleta de Logs.

• Uma entidade deve ter um tipo. Quase 100 tipos de entidade definidos pela Oracle já estão disponíveis. Consulte Tipos de Entidade Modelados no Logging Analytics. Você também pode criar tipos de entidade personalizados. Quando uma entidade é criada, um tipo de entidade define as propriedades que são usadas para localizar o local dos arquivos de log. Por exemplo, em um tipo de entidade do Oracle Database, forneça valores de caminho para propriedades como ADR_HOME, ORACLE_HOME e INSTALL_HOME. Você pode criar novos tipos de entidade usando a API REST ou a CLI. Consulte API do Logging Analytics e Referência de Linha de Comando.

• 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. Consulte Gerenciar a Associação entre Entidade e Origem.

• Para interromper a coleta de logs de uma entidade, desassocie a entidade da origem. Consulte Interromper Coleta de Logs de uma Entidade.

Para executar outras ações na entidade, na página Entidades, selecione o compartimento da sua entidade na seção Escopo de Entidades e restrinja a pesquisa da sua entidade selecionando o tipo de entidade na seção Filtros. Depois de identificar sua entidade, clique no ícone Ações na linha da entidade:

• Exibir Detalhes: A página da entidade é exibida. Na guia Informações da Entidade, você pode exibir o tipo de entidade, o OCID, o tipo de criação, o compartimento no qual ela reside, os detalhes do agente de gerenciamento, a hora em que ele foi criado e a última atualização e as origens associadas. Clique no ícone Editar ao lado de Agente de Gerenciamento para atualizar as informações do agente. Na guia Tags, você pode exibir as tags associadas à entidade. Clique no botão Adicionar Tag para adicionar uma.

  Além disso, clique no botão Editar, Mover Recurso, Adicionar Tags ou Excluir na página da entidade para executar as ações correspondentes.

• Editar: A caixa de diálogo Editar Entidade é exibida. Aqui, para adicionar mais propriedades, clique no botão Adicionar na seção Propriedades e especifique o Nome da Propriedade e o Valor da Propriedade. Clique em Salvar Alterações.

  Essas propriedades são usadas para encontrar o local dos arquivos de log. Por exemplo, em um tipo de entidade do Oracle Database, forneça valores de caminho para propriedades como ADR_HOME, ORACLE_HOME e INSTALL_HOME.

• Adicionar Dados: A caixa de diálogo Configurar Coleta de Logs Baseada em Agente ou Configurar coleta de logs para recursos do OCI é exibida, dependendo se a entidade é um recurso do OCI ou não do OCI. Os assistentes ajudam você a associar a entidade a uma fonte adequada. Isso configura o analisador e o filtro para processar os registros de log que fluem da entidade.

• Fazer Upload de Arquivos: O assistente Fazer Upload de Arquivos é aberto. Siga as etapas do assistente para fazer upload de arquivos de log associados à entidade. Isso é particularmente útil para fazer upload de um lote de arquivos que não fazem parte da coleta contínua de logs ou que pertencem a um intervalo de tempo fora do que está definido para coleta.

• Copiar OCID: O OCID do recurso da entidade é copiado. Você pode usá-lo para fazer referência a esse recurso em qualquer lugar do Oracle Cloud Infrastructure.

• Mover Recurso: A caixa de diálogo Mover Recurso para Outro Compartimento é exibida. Nas opções, selecione o compartimento para o qual deseja mover a entidade e clique em Mover Recurso.

• Adicionar Tag: Consulte Adicionar Tags a Recursos do Logging Analytics.

• Excluir: Talvez você precise excluir algumas entidades antigas ou não utilizadas para estar de acordo com os limites de serviço do Logging Analytics. Consulte Limites por Serviço na Documentação do Oracle Cloud Infrastructure. Para excluir a entidade, confirme na caixa de diálogo Excluir Entidade.

  Observação
  
  

  As entidades que você excluiu usando a API de exclusão de entidade podem reaparecer na listagem de entidades em qualquer uma das seguintes circunstâncias:

  • Novos logs são enviados para as entidades excluídas por meio de coleções do Service Connector Hub ou do Object Storage.

  • Os novos uploads da Ponte do EM contêm a entidade excluída.