Coletar Dados de Modelo de Entidade do Enterprise Manager Cloud Control e Coletar Logs

O Oracle Enterprise Manager Cloud Control (EM) é a solução de gerenciamento de tecnologia de informação da empresa (TI) da Oracle, que fornece solução completa, integrada e orientada aos negócios de gerenciamento da nuvem da empresa. O EM coleta informações adicionais sobre entidades, como informações de configuração necessárias para localizar arquivos de log e relacionamentos entre entidades, a fim de fornecer views topológicas de aplicativos. Essas views topológicas entre os componentes da pilha de aplicativos ajudam a solucionar facilmente os problemas com a disponibilidade e o desempenho dos aplicativos. Os usuários existentes do EM podem configurar a Ponte do EM e se beneficiar da configuração automatizada que importa seus dados de modelo de entidade, como associações de entidades e informações de propriedades do EM para o Oracle Logging Analytics. As informações de associação de entidade são usadas então para construir a topologia no Oracle Logging Analytics.

Mais informações sobre a coleta de dados do EM:

  • Os destinos do EM que representam os recursos locais são equivalentes às entidades no Oracle Logging Analytics. Portanto, você pode aproveitar os destinos descobertos no EM para obter uma integração mais rápida no Logging Analytics, EM vez de criá-los novamente.

  • A topologia no EM, incluindo a de destinos compostos complexos, é mantida e reproduzida no Oracle Logging Analytics. As associações de destino no EM são convertidas EM relações de entidade no Oracle Logging Analytics, evitando a perda de informações.

  • Os metadados de destino relevantes no EM são armazenados como propriedades de entidade no Oracle Logging Analytics, permitindo um melhor monitoramento desses recursos do EM.

  • As propriedades de entidade são atualizadas periodicamente com as informações de destino transferidas do EM para o OCI Object Storage e, por sua vez, coletadas pelo Oracle Logging Analytics usando uma Ponte do EM.

    • Imediatamente depois de configurar a Ponte do EM, as informações sobre os alvos do EM e suas associações são coletadas.

    • A periodicidade de transmissão de informações do EM e sua coleta no Oracle Logging Analytics posteriormente:

      Métricas de configuração e associações de destino: Diariamente

      Propriedades de destino e de destino: Por Hora

Visão geral do workflow para coletar dados do EM:


Visão geral do workflow para coletar dados do EM

Para poder coletar o modelo de dados de entidade do EM, você deve primeiro agrupar os destinos no EM para o serviço Oracle Logging Analytics. Crie uma Cloud Bridge EM seu ambiente monitorado pelo EM para exportar as informações de destino para o OCI Object Storage. Depois de confirmar que os dados da entidade foram coletados no Object Storage, crie uma Ponte do EM entre o Object Storage e o Oracle Logging Analytics para importar as informações de entidades para o Oracle Logging Analytics. As entidades são criadas automaticamente no Oracle Logging Analytics usando as informações coletadas do EM. Para coletar seus logs de seus destinos no EM, associe as entidades criadas automaticamente a origens de log para que os logs possam ser coletados usando Agentes de Gerenciamento.

Estas são as etapas de visão geral para coletar dados do EM e coletar logs:

  1. Crie um Bucket do OCI Object Storage para coletar dados de destino no EM. Consulte Criar um Bucket: Usando a Console.

  2. Antes de configurar a Ponte do EM, prepare o ambiente do EM para exportar as informações necessárias para o OCI. Consulte Pré-requisitos para Criar a Ponte do EM.

    Nesse ponto, a conectividade do OCI é configurada e o upload dos dados de destino é feito automaticamente em intervalos frequentes no OCI Object Storage.

  3. Usando o nome do compartimento e o nome do bucket que você especificou no EM ao configurar a ponte da Nuvem, verifique no OCI Object Storage se os dados de entidades foram coletados com sucesso. Consulte Exibir Detalhes do Bucket: Usando a Console na Documentação do Oracle Cloud Infrastructure.

  4. Instale os Management Agents EM seus hosts do EM para coletar continuamente logs das entidades do EM:

    Consulte a Documentação do Oracle Management Agents para concluir as seguintes tarefas:

    • Executar pré-requisitos para implantação de Agentes de Gerenciamento

    • Instalar Management Agents

  5. Crie políticas de IAM para coletar as informações de entidades do Object Storage. Consulte Permitir que os Usuários Executem Operações da Ponte do EM.

  6. Agora que as informações de entidades estão disponíveis no OCI Object Storage, crie uma Ponte do EM para coletá-las e crie o modelo de dados de entidades, que ajuda a executar uma análise de log completa para monitorar os destinos do EM. Ao criar a Ponte do EM, as entidades são criadas automaticamente no Oracle Logging Analytics.

    Observação

    • Criar Operação da Ponte do EM:

      Cada Ponte do EM deve ter um nome para exibição exclusivo em uma tenancy específica.

      Só pode haver uma Ponte do EM para um bucket de armazenamento de objetos do OCI específico em uma determinada tenancy.

    • Excluir Operação da Ponte do EM:

      Se você excluir uma Ponte do EM, as entidades que foram criadas automaticamente utilizando-a não serão excluídas.

      Se um destino for excluído no EM, a entidade correspondente não será automaticamente excluída no Oracle Logging Analytics.

    • Alterando o Compartimento da Ponte do EM:

      Essa operação só move o recurso de Ponte do EM para outro compartimento. As entidades criadas automaticamente quando você cria a ponte do EM não podem ser movidas para outros compartimentos.

  7. Certifique-se de ativar o recurso de associação automática para as origens específicas que você deseja associar às entidades do EM. Consulte Ativar Associação Automática para uma Origem. Após a criação da Ponte do EM, as entidades elegíveis são associadas automaticamente às origens relevantes.

Nesse ponto, os logs iniciarão a coleta dos destinos do EM para o Oracle Logging Analytics. Você pode vê-los no explorador de logs.

Pré-requisitos para Criar a Ponte do EM

Antes de criar a Ponte do EM para coletar dados de entidades no Armazenamento de Objetos, execute as tarefas a seguir no ambiente do EM. Para obter etapas detalhadas, consulte Integrating Enterprise Manager with OCI Services no Enterprise Manager Cloud Control Administrator's Guide.

  • Defina uma Credencial Nomeada Global no Enterprise Manager para OCI.

  • Configure um usuário exclusivo para o log-in no Enterprise Manager.

  • Crie um grupo do Enterprise Manager que contenha os destinos cujos dados você deseja exportar para o Oracle Logging Analytics.

  • Defina Credenciais Preferenciais do Host para todos os hosts do OMS.

  • Exportar os Dados do Enterprise Manager para o OCI criando uma Cloud Bridge. Selecione Logging Analytics como Serviço do OCI que consumirá os dados e especificará o grupo de destino criado anteriormente.

  • Verifique o status de upload de dados do Oracle Logging Analytics no EM.

Permitir que os Usuários Executem Operações de Ponte do EM

Tipo de recurso individual: loganalytics-em-bridge

Parte do resource-type agregado: loganalytics-resources-family

Caso de Uso Políticas de IAM

A Ponte do EM pode estar EM qualquer compartimento na tenancy

  1. Exemplo de regra para criar um grupo dinâmico para recursos de ponte do EM:

    ALL {resource.type='loganalyticsembridge'}

  2. Exemplo de instrução de política para fornecer permissões aos usuários ou grupos de usuários para GERENCIAR o recurso da Ponte do EM:

    allow group <user_group> to MANAGE loganalytics-em-bridge in tenancy

  3. Exemplo de instrução de política para permitir que o grupo dinâmico de recursos da ponte do EM LEIA o armazenamento de objetos:

    allow dynamic-group <group_name> to read objects in tenancy

A Ponte do EM pode estar EM um compartimento específico

  1. Exemplo de regra para criar um grupo dinâmico para recursos de ponte do EM:

    ALL {resource.type='loganalyticsembridge', resource.compartment.id=<loganalyticsembridge_resource_compartment_OCID>}

  2. Exemplo de instrução de política para fornecer permissões aos usuários ou grupos de usuários para GERENCIAR o recurso da Ponte do EM:

    allow group <user_group> to MANAGE loganalytics-em-bridge in compartment id <compartment_OCID>

  3. Exemplo de instrução de política para permitir que o grupo dinâmico de recursos da ponte do EM LEIA o armazenamento de objetos:

    allow dynamic-group <group_name> to read objects in compartment <compartment_name>

Os exemplos acima fornecem a permissão MANAGE para loganalytics-em-bridge na tenancy ou em um compartimento específico.

As seguintes operações podem ser executadas com cada verbo quando você cria uma política do serviço IAM para loganalytics-em-bridge:

Inspect Read Use Manage

Listar as pontes do EM e seu resumo

Obter detalhes sobre uma ponte do EM

Usar tem o mesmo nível de permissões e operações de API que Ler.

Crie, atualize ou exclua uma ponte do EM ou mova-a para outro compartimento.

Adicionar uma Ponte do EM

  1. No Logging Analytics, clique em Administração. A página Visão Geral da Administração é aberta.

  2. Clique em Pontes do EM na lista de recursos disponíveis.

    A página de listagem de Pontes do EM mostrará todas as Pontes do EM disponíveis.

  3. Clique em Criar Ponte.

    A caixa de diálogo Criar Ponte é aberta.

  4. Digite as seguintes informações:

    1. Nome da Ponte: O nome para exibição da Ponte do EM

    2. Compartimento da Ponte: O compartimento no qual o recurso de Ponte do EM deve ser criado. Isso é definido automaticamente como o compartimento selecionado na página de listagem de Pontes do EM.

    3. Descrição (Opcional): A descrição da Ponte do EM

    4. EM Configuração da Ponte do OEM, seção Compartimento do Object Storage: O compartimento no Object Storage no qual os dados do EM são armazenados

    5. EM Configuração da Ponte do OEM Side, seção Bucket do Object Storage: O nome do bucket no Object Storage no qual os dados do EM são armazenados

    6. Compartimento de Entidades: O compartimento no qual as entidades devem ser criadas

    Clique em Criar.

Operações de Ponte do EM Usando a CLI

Antes de começar a usar a CLI para executar operações da Ponte do EM,

Listar as Operações Disponíveis da Ponte do EM

Consulte em-bridge.

Criar uma Ponte do EM

Para criar uma Ponte do EM, consulte em-bridge: create. Por exemplo:

oci log-analytics em-bridge create -ns <Namespace> -c <Object_Storage_Compartment_OCID> --display-name <EM_Bridge_Name> --bucket-name <Object_Storage_Bucket_Name> --description "<EM_Bridge_Description>" --em-entities-compartment-id <Entity_Compartment_OCID>

No exemplo de comando da CLI anterior:

  • Namespace: Namespace da sua tenancy

  • Object_Storage_Compartment_OCID: OCID do compartimento no Object Storage no qual os dados do EM são armazenados

  • EM_Bridge_Name: O nome para exibição da Ponte do EM

  • Object_Storage_Bucket_Name: O nome do bucket no Object Storage no qual os dados do EM são armazenados

  • EM_Bridge_Description: A descrição da Ponte do EM

  • Entity_Compartment_OCID: OCID do compartimento no qual as entidades devem ser criadas

Obter os Detalhes Sobre uma Ponte do EM

Para obter os detalhes sobre a Ponte do EM, consulte em-bridge: get.

Comandos de exemplo para obter mais detalhes sobre a Ponte do EM:

  1. oci log-analytics em-bridge get -ns <Namespace> --bridge-id <EM_Bridge_OCID>
  2. oci log-analytics entity get -ns <Namespace> --bridge-id <EM_Bridge_OCID>

Listar as Pontes do EM

Para listar as Pontes do EM, consulte em-bridge: list.

Comando de exemplo para listar as Pontes do EM:

oci log-analytics em-bridge list -ns <Namespace> -c <EM_Bridge_Compartment_OCID>

Operações de Ponte do EM Usando a API REST

Você pode executar as seguintes operações da Ponte do EM usando a API:

Tipos de Destino do EM e Propriedades Coletadas

A Ponte do EM suporta os seguintes tipos de alvo e suas propriedades:

Tipo de Alvo EM Tipo de Entidade do Logging Analytics Correspondente Propriedades do Alvo do EM Propriedades de Entidade do Logging Analytics
Oracle High Availability Service Nó do Cluster Oracle

NodeName

-

OracleHome

node_name

omc_crs_base

oracle_home

Host

Host (AIX)

Host (HP-UX)

Host (Linux)

Host (Solaris)

Host (Windows)

Nenhum Nenhum
OC4J OC4J

-

omc_server_log_path

Oracle HTTP Server Oracle HTTP Server

{DOMAIN_HOME}{OracleInstance}

ComponentName

ohs_home

component_name

Instância de Banco de Dados Instância do Oracle Database

-

MachineName

Port

ADRHome

SID

ServiceName

OracleHome

diagnostic_dest

audit_file_dest

audit_dest

host_name

port

adr_home

sid

service_name

oracle_home

DIAGNOSTIC_DEST

AUDIT_FILE_DEST

Sistema de Banco de Dados Sistema Oracle Database

Nenhum

Nenhum

Oracle Internet Directory Oracle Internet Directory

IASInternalName

OracleInstance

ias_internal_name

oracle_instance

Listener Listener do Oracle Database

OracleHome

ADRHome

{ORACLE_HOME}/../diag/tnslsnr/*/{LSNR_ALIAS}/alert

Machine

{ORACLE_HOME}/../diag/tnslsnr/*/{LSNR_ALIAS}/trace

oracle_home

adr_home

log_dir_path

host_name

trace_dir_path

Banco de Dados Plugável Oracle Pluggable Database

Name

MachineName

Port

SID

ServiceName

-

pdb_name

host_name

port

sid

service_name

domain_name

Oracle VM Manager Oracle VM Manager

Nenhum

Nenhum

Pool de Servidores do Oracle VM Pool de Servidores do Oracle VM

Nenhum

Nenhum

ASM do Cluster Gerenciamento Automático de Armazenamento

Nenhum

Nenhum

Gerenciamento Automático de Armazenamento Instância do Gerenciamento de Armazenamento Automático

AdrHome

adr_home

Banco de Dados de Cluster Oracle Database

Nenhum

Nenhum

Componente Siebel Componente Siebel

-

SARMLogDirectory

siebel_component_log_file_name

siebel_component_sarm_log_directory

Siebel Enterprise Oracle Siebel Enterprise

Nenhum

Nenhum

Servidor Siebel Servidor Siebel

filesystem:installdir

filesystem:logdir

-

siebel_server_install_dir

siebel_server_log_dir

siebel_component_sarm_log_directory

Cluster do Oracle WebLogic Cluster do WebLogic

DOMAIN_HOME

omc_weblogic_cluster_home

Domínio do Oracle WebLogic Domínio do WebLogic

DOMAIN_HOME

WebLogicHome

domain_home

weblogic_home

Oracle WebLogic Server WebLogic Server

DOMAIN_HOME

ServerNames

domain_home

server_names

Gerenciador de Nós do Oracle WebLogic Gerenciador de Nós do WebLogic

-

omc_nodemanager_home