Gerenciar Entidades

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

Recursos Úteis:

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

• Para criar uma entidade, consulte Criar uma Entidade para Representar Seu Recurso de Emissão de Log. Além disso, o Log Analytics permite editá-lo posteriormente, movê-lo de um compartimento para outro e executar várias outras tarefas de gerenciamento, conforme listado abaixo.

• Para iniciar a descoberta de entidades como aplicativos, bancos de dados, middleware e outros componentes em pacotes, 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 Log 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 Oracle Database, você deve fornecer 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 Log 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 Associação Origem-Entidade.

• 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 e restrinja sua pesquisa pela sua entidade selecionando o tipo de entidade na barra de pesquisa. 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 no 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 origem adequada. Isso configura o parser 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 no assistente para fazer upload dos 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 aqueles que pertencem a um intervalo de tempo fora do que é 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 Log Analytics.

• Excluir: Talvez seja necessário excluir algumas das suas entidades antigas ou não usadas para estar em conformidade com os limites de serviço do Log 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 coletas do Service Connector Hub ou do Object Storage.

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