Pré-requisitos de Nome de Host

Certifique-se de que o comando hostname -d retorne o nome do domínio ou o comando hostname -a retorne o nome abreviado correto, como primeiro alias. O nome abreviado aparece na coluna HOST_NAME da tabela v$instances do banco de dados a ser descoberto. Isso pode ser feito atualizando o arquivo /etc/hosts para retornar o alias correto como acima para ser o primeiro alias.

Pré-requisitos do Agente

• Cada nó do cluster do Oracle Database deve ter um Management Agent instalado localmente.

• Certifique-se de que o usuário mgmt_agent ou oracle-cloud-agent, com base no tipo de agente instalado, esteja incluído no Grupo do Oracle Inventory (geralmente, oinstall) obtido de /etc/oraInst.loc, para poder executar os comandos lsnrctl, srvctl e crsctl.

  Use a seguinte instrução para conceder privilégios oinstall ao usuário mgmt_agent ou oracle-cloud-agent, com base no tipo de agente instalado:

  • Host com o Oracle Cloud Agent:

    usermod -aG oinstall oracle-cloud-agent

  • Host com agente stand-alone:

    usermod -aG oinstall mgmt_agent

• O grupo deve ter privilégio de execução no diretório de instalação da Oracle.

  Exemplo de adição de permissão de execução de grupo ao diretório:

  chmod g+x /u01/app/oracle

Depois de conceder OS privilégios do Sistema Operacional, use as instruções a seguir para reiniciar o agente. Use as instruções apropriadas para seu agente e SO, respectivamente:

• Oracle Cloud Agent:

  sudo systemctl stop oracle-cloud-agent

  Em seguida, inicie o agente usando o comando start.

• Agente stand-alone:

  sudo systemctl stop mgmt_agent

  Em seguida, inicie o agente usando o comando start.

Pré-requisito de Monitoramento de Credenciais

Antes de descobrir um banco de dados no Stack Monitoring, certifique-se de ter acesso ao usuário de monitoramento. Você pode usar o usuário DBSNMP integrado ao Oracle Database e que tenha os privilégios necessários para monitorar o banco de dados OU criar um usuário personalizado com apenas os privilégios necessários. As etapas para criar um usuário de monitoramento de banco de dados podem ser encontradas na nota do CMOS KB57458.

Para o ASM:

• Você precisa usar um perfil de usuário ASMSNMP ou seus privilégios.
• O usuário deve ter uma senha de segredo para o ASM. Para começar a criar um segredo, consulte Gerenciando Segredos.

Pré-requisito do Oracle Database ativado para TCPS

O Stack Monitoring suporta protocolos de conectividade TCP e TCPS para bancos de dados Oracle. O protocolo TCPS permite que um aplicativo Oracle em um cliente se comunique com bancos de dados remotos por meio de TCP/IP e SSL, o que fornece maior segurança que o TCP sozinho. Esse novo listener pode ser usado para falar com o banco de dados por meio de um canal seguro. Para descobrir um banco de dados com TCPS, o pré-requisito seria adicionar um listener TCPS ao banco de dados Oracle e acessar o local da wallet, conforme mostrado nas quatro etapas a seguir.

Etapa 1: Configurando o Oracle Database e o listener para suportar TCPS. Consulte Configurando a Autenticação de Segurança da Camada de Transporte.

Etapa 2: Importar KeyStore/TrustStore para o Management Agent e atualizar suas permissões.

1. Identifique e exporte o local da wallet do Oracle Database de acordo com o tipo KeyStore usado (PKCS ou JKS)..

   PKCS

   export WALLET_LOCATION=<database_wallet_location>/dbwallets

   JKS

   export WALLET_LOCATION=<database_wallet_location>/jkswallets

2. Copie a wallet para um diretório seguro e legível no host do agente.

   cp -r $WALLET_LOCATION <secure_readable_dir>/

3. Atualize a permissão da wallet.

   No OCI Compute

   PKCS

   sudo chown -R oracle-cloud-agent:oracle-cloud-agent <secure_readable_dir>/dbwallets

   JKS

   sudo chown -R oracle-cloud-agent:oracle-cloud-agent <secure_readable_dir>/jkswallets

   Computação On-premises:

   PKCS

   sudo chown -R mgmt_agent:mgmt_agent <secure_readable_dir>/dbwallets

   JKS

   sudo chown -R mgmt_agent:mgmt_agent <secure_readable_dir>/jkswallets

Etapa 3: Criar um Segredo do OCI.

Para começar a criar um segredo, consulte Gerenciando Segredos.

Exemplos de Segredo:

PKCS

{
    "sslTrustStoreType": "PKCS12",
    "sslTrustStoreLocation": "/<secure_readable_dir>/dbwallets/cwallets/ewallet.p12",
    "sslTrustStorePassword": "<truststore_password>",
    "sslKeyStoreType": "PKCS12",
    "sslKeyStoreLocation": "/<secure_readable_dir>/dbwallets/swallets/ewallet.p12",
    "sslKeyStorePassword": "<truststore_password>",
    "sslServerCertDn": "C=US,O=MyCorp,CN=sslclient"
}

JKS

{
    "sslTrustStoreType": "JKS",
    "sslTrustStoreLocation": "/<secure_readable_dir>/jkswallets/truststore.jks",
    "sslTrustStorePassword": "<truststore_password>",
    "sslKeyStoreType": "JKS",
    "sslKeyStoreLocation": "/<secure_readable_dir>/jkswallets/keystore.jks",
    "sslKeyStorePassword": "<truststore_password>",
    "sslServerCertDn": "C=US,O=MyCorp,CN=sslclient"
}

Etapa 4: Validar Políticas

Além da criação de um segredo, o grupo de administradores do Stack Monitoring deve ter a capacidade de ler o vault no qual o segredo é mantido. Consulte Criar políticas obrigatórias para obter mais informações sobre como conceder permissão de leitura em uma família de segredos dentro de um compartimento especificado.

Se o seu Oracle Database estiver usando versões de senha mais antigas

Para bancos de dados configurados para usar a versão de senha inferior a 12 (SQLNET.ALLOWED_LOGON_VERSION < 12 ), como determinados bancos de dados do E-Business Suite, siga estas etapas adicionais para configurar o Management Agent para se comunicar com o banco de dados usando versões de senha mais antigas, definindo um valor SQLNET.ALLOWED_LOGON_VERSION apropriado na configuração do agente.

Estas instruções se aplicam ao agente em execução no local:

1. Modifique este arquivo /opt/oracle/mgmt_agent/agent_inst/config/emd.properties para adicionar a propriedade:

   dbaas.ALLOWED_LOGON_VERSION = 8 

   Os valores podem ser 8 / 10 / 11 /12 / 12a, dependendo da versão de login permitida que você precisar.

2. Reiniciar o agente.

   sudo systemctl restart mgmt_agent

Estas instruções se aplicam ao agente em execução no OCI Compute:

1. Modifique o arquivo /var/lib/oracle-cloud-agent/plugins/oci-managementagent/polaris/agent_inst/config/emd.properties para adicionar esta propriedade:

   dbaas.ALLOWED_LOGON_VERSION = 8

   Os valores podem ser 8 / 10 / 11 /12 / 12a, dependendo da versão de login permitida que você precisar.

2. Reiniciar o agente.

   sudo systemctl restart oracle-cloud-agent

Instruções de Descoberta do Oracle Database

• Descobrindo o Sistema de BD se o Oracle Database já tiver sido descoberto
• Entrada da Descoberta
  • Entrada da Descoberta da UI
  • Entrada da Descoberta da CLI

Descobrindo o Sistema de BD se o Oracle Database já tiver sido descoberto

1. Descoberta da Interface do Usuário para o primeiro Sistema de BD do cluster:

   Na página Descoberta de Recursos, conclua a descoberta do Oracle Database em branco.

   Para obter mais informações sobre entradas de descoberta da IU, consulte a tabela Entrada de Descoberta da IU.

2. Descoberta da CLI para os recursos restantes do Sistema de BD:

   Observação
   
   Para um Oracle Database que já tenha sido descoberto, conclua as etapas a seguir para descobrir o Sistema de BD relacionado.
   1. Navegue até a guia Configuração na home page recém-criada do Oracle Database. Copie os seguintes campos da tabela Propriedades Gerais do OCI para um bloco de notas:

      Nome da Propriedade	Nome da Variável CLI	Observações
      OCID	<Database_Resource_OCID>
      compartmentId	<Compartment_OCID>
      managementAgentId	<Additional_Agent#_OCID>	Este é o OCID do agente usado durante a descoberta da CLI.

   2. Copie o nome do recurso do Oracle Database na parte superior da home page do Stack Monitoring Oracle Database.
   3. Obtenha o OCID do Management Agent dos outros nós do cluster:

      1. Navegue até Observabilidade e Gerenciamento, vá para Management Agents e clique em Agentes.

      2. Para cada agente adicional no cluster do Sistema de BD, selecione o menu de ação.
      3. Selecione Copiar OCID para a área de transferência.

         OCID do Agente	Nome da Variável CLI
         1o nó adicional no cluster	<Additional_Agent1_OCID>
         2o nó adicional no cluster (etc)	<Additional_Agent2_OCID>

   4. Atualize o JSON_INPUT_FILE com os valores obtidos e use a seguinte sintaxe para descobrir um Sistema Oracle DB:

      oci stack-monitoring discovery-job create --compartment-id "<Compartment_ID>" --from-json file://<JSON_INPUT_FILE>

   Para obter mais informações sobre entradas de descoberta da CLI, consulte a tabela Entrada de Descoberta da CLI.

   Veja a seguir exemplos de payload JSON para descobrir os recursos restantes do Sistema de BD:

   {
     "discoveryType": "REFRESH",
     "discoveryClient": "APPMGMT",
     "compartmentId": "<COMPARTMENT_OCID>",
     "discoveryDetails": {
       "agentId": "<OCID of the Management agent>",
       "resourceType": "ORACLE_DATABASE",
       "resourceName": "<Resource name to display in Stackmonitoring UI>",
       "properties": {
         "propertiesMap": {
               "resource_id":"<DATABASE_OCID>",
               "asm_host":"<ASM HOSTNAME>",
               "asm_service_name":"+ASM",
               "is_asm_discovery":"true",
               "asm_port":"1521",
               "additional_agent_1":"ADDITIONAL_AGENT1_OCID",
               "additional_agent_2":"ADDITIONAL_AGENT2_OCID"
         }
       },
       "credentials": {
         "items": [
               {
             "credentialName" : "QVNNUGFzc3dvcmRJblZhdWx0",
             "credentialType" : "U1NMX1NFQ1JFVF9JRA==",
             "properties": {
               "propertiesMap": {
                 "ASMUserName": "<ASM user name in base64 encoded format>",
                 "PasswordSecretId": "<Encoded ASM user secret ocid in BASE64 encoded format>",
                 "ASMRole":"<ASM user role in base64 encoded format>"
               }
             }
           }
         ]
       }
     }
   }

Para obter mais informações sobre a atualização do Sistema do Oracle DB, consulte Atualização de Componentes do Sistema do Oracle Database.

Oracle Database

Descubra um Oracle Database incluindo o sistema de banco de dados usando a interface do usuário: Na página Descoberta de Recursos, preencha a interface do usuário preenchida em branco para descobrir um Oracle Database, incluindo o sistema de banco de dados e seus componentes.

Para incluir vários agentes ao descobrir um sistema de banco de dados para RAC com vários nós, execute as seguintes etapas:

Entrada da Descoberta

• Entrada da Descoberta da UI

  Campo de entrada	Descrição
  Nome do Recurso	Nome do banco de dados
  Nome do host ou Nome de SCAN do DNS	Sistema de Nomes de Domínio (DNS) ou Nome de Acesso de Cliente Único (SCAN) do banco de dados
  Porta	Porta usada pelo banco de dados fora do Oracle Cloud Infrastructure para conexões de banco de dados
  Nome do Serviço	Nome do serviço do banco de dados fora do Oracle Cloud Infrastructure que será usado pela conexão
  Protocolo	Protocolo usado para o Oracle Database. Selecione o protocolo TCP ou TCPS
  Segredo da senha do usuário do banco de dados no compartimento <compartment_name>	Selecione na lista drop-down o segredo que contém a senha do usuário do banco de dados. Esse campo só será exibido se a opção TCPS estiver selecionada no campo Protocolo. Veja abaixo.
  Agentes de Gerenciamento	Management Agents que monitoram o host no qual o banco de dados está instalado Observação Para sistemas de banco de dados que abrangem vários hosts, selecione todos os Management Agents implantados em todos os hosts do sistema de banco de dados.
  Credenciais do Banco de Dados para Monitoramento	.
  Nome Usuário	Nome de usuário das credenciais de monitoramento do Oracle Database
  Senha	Senha no formato codificado da base 64 das credenciais de monitoramento do Oracle Database
  Atribuição	Atribuição de banco de dados no formato codificado de base 64 do usuário de monitoramento de banco de dados (Normal ou SYSDBA)
  Informações do ASM
  Agente de Gerenciamento	Agente de Gerenciamento monitorando o host no qual o banco de dados está instalado. Para descobrir o cluster e o agente do listener devem ser instalados no host do banco de dados.
  Gerenciador de Armazenamento Automático	Ativar ou Desativar. Ativado por default.
  Nome do host ou nome de Scan do DNS	O nome padrão de dns ou SCAN no qual a instância ASM reside.
  Porta	A porta usada pelo ASM. Valor padrão: 1521
  Nome do Serviço	O nome do serviço ASM
  Credenciais do ASM para Monitoramento
  Nome Usuário	Nome de usuário do ASM no formato codificado de base 64
  Segredo da senha do usuário do ASM no compartimento atual	Segredo da senha no formato codificado de base 64 conforme definido no serviço OCI Vault
  Atribuição	Função no formato codificado de base 64. SYSMAN por padrão. Valores possíveis: SYSASM, SYSDBA, SYSOPER
  Descobrir em
  Stack Monitoring e Log Analytics (recomendado)	Os resultados da descoberta serão enviados ao Stack Monitoring e ao Log Analytics. Observação Para obter informações sobre o Log Analytics, consulte Início Rápido.
  Stack Monitoring apenas	Os resultados da descoberta serão enviados somente para o Stack Monitoring.
  Somente Log Analytics	Os resultados da descoberta serão enviados somente para o Log Analytics.
  Licença
  Enterprise Edition	O recurso receberá uma licença do Enterprise Edition.
  Standard Edition	O recurso receberá uma licença da Standard Edition.
  Tags (em Mostrar opções avançadas)	Tags de Formato Livre e Definidas podem ser aplicadas aos recursos do Stack Monitoring durante a descoberta. Para usar Tags Definidas, primeiro crie os namespaces de Tag, consulte . Consulte Conceitos de Tags e Namespace de Tag para obter detalhes sobre como criar e gerenciar os namespaces de Tag para Tags Definidas. Ao descobrir um recurso, qualquer tag designada será aplicada a todos os recursos descobertos. Para obter mais informações sobre pré-requisitos de Tag e propagação de Tag, consulte Gerenciando Tags.
  Namespace de Tag	Selecione "Nenhum" para adicionar uma tag de formato livre. Selecione um namespace para adicionar uma tag definida no namespace. Se você tiver permissões para criar um recurso, também terá permissões para aplicar tags de formato livre a esse recurso. Para aplicar uma tag definida, você deverá ter permissões para usar o namespace de tag. Para obter mais informações sobre tags, consulte Tags de Recurso. Se você não tiver certeza se deve aplicar tags, ignore essa opção (você poderá aplicar tags posteriormente) ou pergunte ao administrador.
  Chave de Tag	Especifique o nome que você usa para fazer referência à tag.
  Valor da Tag	Especifique o valor da tag. Para obter mais detalhes sobre Chave de Tag e Valor de Tag, consulte Visão Geral do Serviço Tagging.

• Entrada da Descoberta da CLI

  Variável de Entrada da CLI	Descrição
  <Additional_Agent1_OCID>	1o nó adicional no cluster
  <Additional_Agent2_OCID> (etc)	2o nó adicional no cluster (continuar para cada nó adicional no cluster)
  Agent_OCID	Agente do OCID de descoberta inicial
  Compartment_OCID	O OCID do compartimento no qual o Sistema Oracle Database será monitorado

Pré-requisitos

Se você tiver ativado o Oracle WebLogic Server com SSL, exporte o certificado de seu armazenamento de chaves e importe-o no Management Agent KeyStore. Para obter mais informações sobre como configurar o SSL no Servidor WebLogic, consulte Configurando o SSL.

Importar TrustStore para o Management Agent

1. Designe um subdiretório persistente no sistema de arquivos do agente de gerenciamento para armazenar os armazenamentos de confiança e os armazenamentos de chaves do Stack Monitoring. Exporte o certificado da área de armazenamento de chaves SSL JMX da instância WLS para a Área de Armazenamento Confiável do Stack Monitoring. Por exemplo, em um host do UNIX:

   keytool -exportcert -alias <alias of WLS SSL key> -file <Exported Cert Name> -keystore <path to the WLS SSL Keystore>.keystore -storepass <WLS SSL Keystore password> -rfc

2. Importe o armazenamento de chaves SSL JMX da instância WLS para o Armazenamento Confiável do Stack Monitoring no sistema de arquivos do agente de gerenciamento:

   keytool -importcert -noprompt -alias <alias agent's truststore key> -file <Exported Cert Name>.cer -keystore AgentTrust.jks -storepass <Agent truststore password, default is "welcome">

3. Copie o arquivo de Armazenamento Confiável do Stack Monitoring e atualize suas permissões.

   Identifique o local seguro legível do Management Agent no host do agente.

   cp <path_to_truststore_file/AgentTrust.jks <secure_readable_dir>/

   No OCI Compute:

    sudo chown oracle-cloud-agent:oracle-cloud-agent <secure_readable_dir>/AgentTrust.jks

   Computação on-premises:

   sudo chown mgmt_agent:mgmt_agent <secure_readable_dir>/AgentTrust.jks

4. Use o caminho completo do Armazenamento Confiável, por exemplo, <secure_readable_dir>/AgentTrust.jks no "Caminho TrustStore" da Descoberta de Recursos se o Domínio WebLogic tiver T3S e "JKS" como o "Tipo de Armazenamento Confiável".

Configurar MBeans em Oracle WebLogic Servers

Para coletar as métricas de desempenho da JVM da plataforma MBeans, o MBeans deve ficar acessível por meio do runtime MBeanServer. Ative MBeans fazendo log-in no Oracle WebLogic Server e verifique a ativação executando o script WLST:

1. Ativar MBeans em Oracle WebLogic Servers

   Ative MBeans acessando cada Oracle WebLogic Server fazendo log-in nele ou na console WebLogic da seguinte forma:

   • Faça log-in no Oracle WebLogic Server:

     Siga as ações do usuário na demonstração da sessão da Ferramenta de Script WebLogic em Activating Platform MBeans no WebLogic Server 9.x to 10.3.2 versions no Enterprise Manager Cloud Control Middleware Management Guide.

   • Acesse a console WebLogic:

     Navegue até Domínio > Configuração > página Geral > opções Avançadas. Marque a caixa de seleção Servidor de Plataforma MBean Usado.

   Se MBeans não for registrado depois que você tiver seguido as etapas acima, inicie os Servidores Oracle WebLogic com a seguinte propriedade do sistema:

   -Djavax.management.builder.initial=weblogic.management.jmx.mbeanserver.WLSMBeanServerBuilder

2. Verifique a Ativação de MBeans

   Para verificar se o MBeans foi ativado com sucesso, execute o script WLST disponível em Using the Platform MBean Server no Fusion Middleware Developing Custom Management Utilities With JMX for Oracle WebLogic Server. O script WLST demonstra como usar a Plataforma MXBeans para monitorar os recursos de um domínio do Oracle WebLogic Server em execução.

   Certifique-se de que MBeans esteja registrado em java.lang.

Garanta a conectividade entre o agente de gerenciamento e todos os servidores em WebLogic

Durante a descoberta, o Agente de Monitoramento de Pilha se comunica com AdminServer para descobrir a topologia de domínio. O monitoramento pós-descoberta é feito comunicando-se diretamente com servidores gerenciados. Para que isso aconteça, verifique o seguinte:

• O Management Agent pode se comunicar com todos os servidores gerenciados no domínio.
• O host e as portas dos servidores gerenciados são acessíveis ao agente.
• Se os filtros estiverem configurados para bloquear o tráfego de entrada em servidores gerenciados, ajuste os filtros para que o agente se comunique com os servidores gerenciados.

WebLogic Resultados de Descoberta Específicos do Cenário

1. O domínio WebLogic tem dois Servidores e um deles está inativo.

   Resultado da Descoberta: O domínio WebLogic será descoberto com apenas um Servidor que está em execução, ignorando o que não está em execução.

2. Um domínio WebLogic tem um Cluster com dois Servidores e um deles está inativo.

   Resultado da Descoberta: O cluster WebLogic será descoberto apenas com um Servidor que esteja em um estado de execução.

3. Um domínio WebLogic tem um Cluster que contém apenas um Servidor que não está no estado de execução.

   Resultado da Descoberta: Nem o Cluster nem o Servidor serão descobertos

WebLogic Entrada da Descoberta

Topologia do EBS

Quando uma instância do E-Business Suite é descoberta, os recursos EBS e WebLogic são descobertos. A descoberta de OHS e Banco de Dados deve ser feita separadamente.

Para monitorar o Oracle HTTP Server colocado no EBS, consulte "Descoberta do OHS". Depois que o OHS for descoberto de forma independente, uma associação pode ser criada entre o recurso EBS e o recurso OHS.

Para monitorar o banco de dados do EBS, se o banco de dados for descoberto primeiro e, em seguida, o EBS for descoberto posteriormente, a associação do tipo usas será criada automaticamente entre o recurso do EBS e o recurso do banco de dados no final da descoberta do EBS. Aqui, o recurso EBS se refere a um tipo de recurso do Stack Monitoring ebs_instance e o recurso de banco de dados se refere ao tipo de recurso do Stack Monitoring oci_oracle_db ou oci_oracle_pdb.

Se o EBS for descoberto antes da descoberta do banco de dados, a topologia poderá ser atualizada de duas maneiras.

• Criar Associação entre Instância do EBS e Recursos do Banco de Dados
• Atualizando a topologia do EBS

Criar Associações:

Os recursos EBS compostos não podem ser associados diretamente a um host. No entanto, os recursos filhos do EBS podem ser associados da seguinte forma:

• Host do EBS Concurrent Manager uses
• Host do Nó CP do EBS uses

Veja a seguir a sintaxe do comando da CLI do OCI para criar uma associação entre dois recursos.

oci stack-monitoring resource associate --association-type uses --compartment-id "<Compartment_OCID>" --source-resource-id "<Resource_OCID>" --destination-resource-id "<Database_Resource_OCID>"

Por exemplo:

oci stack-monitoring resource associate --association-type uses --<Compartment_OCID>
      ocid1.compartment.oc1..unique_ID --<Source_Resource_OCID>
      ocid1.stackmonitoringresource.oc1.iad.unique_ID --<Destination_Resource_OCID>
      ocid1.stackmonitoringresource.oc1.iad.unique_ID

No caso do EBS, o comando acima pode ser usado para criar uma associação entre o EBS e os recursos do banco de dados especificando <Source_Resource_OCID> como ID de recurso do EBS e <Destination_Resource_OCID> como ID de recurso do banco de dados.

Uma descoberta do EBS, associada a seus recursos subjacentes, é representada no Stack Monitoring, conforme visto no seguinte diagrama:

Pré-requisitos

1. Configurar MBeans em Oracle WebLogic Servers
2. Verificar Coleta de Dados de Sessões de Formulários
3. Configurar o DNS em um Ambiente do Oracle E-Business Suite
4. Adicione o Banco de Dados usado pelo aplicativo E-Business Suite.

   Se ainda não tiver feito isso, adicione o banco de dados que será usado para o aplicativo E-Business Suite. Consulte Oracle Database (Descoberta)

5. Permissões do agente para monitoramento do Listener do Aplicativo
6. Requisitos do E-Business Suite Database Monitoring para Stack Monitoring

Verificar Coleta de Dados de Sessões de Formulários

Verifique o conjunto de dados de sessões de formulários para exibi-lo posteriormente nas métricas de recursos do Sistema de Formulários executando a tarefa a seguir. Além das etapas executadas no Oracle WebLogic Domain (Configure MBeans on Oracle WebLogic Servers). Se esta etapa não estiver configurada, algumas das métricas do Sistema de Formulários não serão coletadas.

Quando você faz log-in no Oracle E-Business Suite, o sistema cria uma sessão de usuário no banco de dados identificado por um ID de sessão exclusivo (SID) usando a credencial de esquema do APPS. Cada sessão do banco de dados é associada a um usuário do aplicativo Oracle E-Business Suite. Isso permite vincular a sessão do banco de dados ao usuário do aplicativo para fins de solução de problemas. Usando uma sessão do Forms, você pode determinar como o usuário do Oracle E-Business Suite abriu uma sessão do banco de dados.

1. Faça log-in no Oracle E-Business Suite.
2. Na interface do usuário, navegue até Administrador do Sistema, clique em Perfil e, em seguida, em Sistema.
3. Certifique-se de que o valor de Sign-On: Nível de Auditoria esteja definido como FORM. Defina isso no nível do local.
4. Certifique-se de que o valor de AuditTrail: Activate esteja definido como YES.

Salve as alterações.

Configurar o DNS em um Ambiente do Oracle E-Business Suite

Os hosts do Oracle E-Business Suite devem ser capazes de detectar um ao outro na rede. Por exemplo, no ambiente UNIX, os servidores DNS são configurados no arquivo /etc/resolv.conf em cada host.

Para verificar se os servidores DNS estão configurados corretamente, execute o comando:

nslookup any_publicDomain_hostname

Substitua <any_publicDomain_hostname> pelo nome do host de qualquer outro host do ambiente EBS que não seja o host local.

Aqui está um exemplo de uma saída bem-sucedida que valida o servidor DNS está configurada corretamente:

$ nslookup node02.examplehost.com

Server:         937.486.274.354
Address:        937.486.274.354

Non-authoritative answer:
Name:   node02.examplehost.com
Address: 135.756.247.46

Permissões do agente para monitoramento do Listener do Aplicativo

O agente deve ser instalado no mesmo host do EBS para monitorar o Listener do Aplicativo EBS. Caso contrário, o recurso sempre será mostrado como DOWN.

Certifique-se de que o usuário mgmt_agent ou oracle-cloud-agent, com base no tipo de agente instalado, esteja incluído no Grupo do Oracle Inventory (normalmente, oinstall) obtido de /etc/oraInst.loc, para poder executar os comandos lsnrctl, srvctl e crsctl.

Use a seguinte instrução para conceder privilégios oinstall ao usuário mgmt_agent ou oracle-cloud-agent, com base no tipo de agente instalado:

• Host com o Oracle Cloud Agent: usermod -aG oinstall oracle-cloud-agent
• Host com agente stand-alone: usermod -aG oinstall mgmt_agent

Exemplo de adição de permissão de execução de grupo ao diretório:

chmod -R g+x+r /u01/install/APPS

Após conceder OS privilégios do SO, use as seguintes instruções para reiniciar o agente. Use as instruções apropriadas para seu agente e sistema operacional, respectivamente:

1. Interromper o Agente
   • Para o Oracle Linux 6:
     • Agente do Oracle Cloud: sudo /sbin/initctl stop oracle-cloud-agent
     • Agente independente: sudo /sbin/initctl stop mgmt_agent
   • Para o Oracle Linux 7
     • Agente do Oracle Cloud: sudo systemctl stop oracle-cloud-agent
     • Agente independente: sudo systemctl stop mgmt_agent
2. Inicie o agente usando o comando start.

Requisitos do E-Business Suite Database Monitoring para Stack Monitoring

O banco de dados Oracle usado para monitorar o banco de dados E-Business Suite (EBS) deve ser descoberto antes de descobrir o aplicativo EBS. Se o banco de dados for descoberto primeiro, ele será associado automaticamente ao aplicativo EBS assim que a descoberta do aplicativo EBS for concluída. Se a descoberta do aplicativo EBS for executada antes que o banco de dados seja descoberto, a associação precisará ser criada manualmente.

O monitoramento do E-Business Suite requer privilégios específicos para acessar o esquema do EBS. A configuração difere dependendo do tipo de banco de dados (DB Não Contêiner versus BD Contêiner e BD Plugável) usado como seu armazenamento de dados EBS. O Stack Monitoring suporta o uso do proprietário do esquema EBS, geralmente APPS, como as credenciais do banco de dados ao descobrir o EBS. É preferível criar um usuário de monitoramento com apenas os privilégios necessários para monitorar um aplicativo EBS. Você pode usar o mesmo usuário do banco de dados para monitorar o banco de dados Oracle que contém o esquema EBS e o aplicativo EBS. As etapas para criar um usuário de monitoramento de banco de dados podem ser encontradas na Observação do MOS: 2857604.1.

Concessões de Banco de Dados

Os privilégios específicos são definidos no código abaixo. Ele assume o nome do esquema EBS de APPS. Se o nome do esquema for diferente em sua configuração, substitua APPS pelo nome do esquema real no código a seguir.

Para verificar se o usuário de monitoramento tem as concessões necessárias e aplicar as concessões ausentes, execute os Scripts EBS a seguir.

Para entender as concessões específicas a serem aplicadas ou aplicar manualmente as concessões, consulte a lista de comandos abaixo a serem executados.

Substitua <your_monitoring_user> pelo usuário de monitoramento do banco de dados criado usando o script. Certifique-se de que as concessões sejam aplicadas ao usuário de monitoramento no qual reside o esquema APPS.

GRANT SELECT ON APPS.FND_OAM_CONTEXT_FILES TO <your_monitoring_user>;
GRANT SELECT ON APPS.FND_PRODUCT_GROUPS TO <your_monitoring_user>;
GRANT SELECT ON APPS.FND_CONC_PROG_ONSITE_INFO TO <your_monitoring_user>;
GRANT SELECT ON APPS.FND_CONCURRENT_PROGRAMS_VL TO <your_monitoring_user>;
GRANT EXECUTE ON APPS.FND_OAM_EM TO <your_monitoring_user>;
GRANT SELECT ON APPS.FND_CONCURRENT_REQUESTS TO <your_monitoring_user>;
GRANT SELECT ON APPS.FND_APPLICATION_VL TO <your_monitoring_user>;
GRANT SELECT ON APPS.FND_CONCURRENT_QUEUES TO <your_monitoring_user>;
GRANT SELECT ON APPS.FND_LOOKUPS TO <your_monitoring_user>;
GRANT SELECT ON APPS.FND_CONCURRENT_WORKER_REQUESTS TO <your_monitoring_user>;
GRANT SELECT ON APPS.FND_CONCURRENT_QUEUES_VL TO <your_monitoring_user>;
GRANT SELECT ON APPS.FND_OAM_FNDUSER_VL TO <your_monitoring_user>;
GRANT SELECT ON APPS.FND_FORM_SESSIONS_V TO <your_monitoring_user>;
GRANT SELECT ON APPS.FND_CP_SERVICES TO <your_monitoring_user>;
GRANT SELECT ON APPS.FND_CONCURRENT_PROCESSES TO <your_monitoring_user>;
GRANT SELECT ON APPS.FND_SVC_COMPONENTS TO <your_monitoring_user>;
GRANT SELECT ON APPS.FND_LOG_MESSAGES TO <your_monitoring_user>;
GRANT SELECT ON APPS.FND_CONCURRENT_PROGRAMS TO <your_monitoring_user>; 
GRANT SELECT ON APPS.FND_CONFLICTS_DOMAIN TO <your_monitoring_user>; 
GRANT SELECT ON APPS.FND_ORACLE_USERID TO <your_monitoring_user>; 
GRANT SELECT ON APPS.FND_APP_SERVERS TO <your_monitoring_user>; 
GRANT SELECT ON APPS.FND_NODES TO <your_monitoring_user>;
GRANT SELECT ON APPS.ICX_SESSIONS TO <your_monitoring_user>;
GRANT SELECT ON APPS.FND_USER TO <your_monitoring_user>;
GRANT SELECT ON APPS.FND_RESPONSIBILITY TO <your_monitoring_user>;
GRANT EXECUTE ON APPS.FND_PROFILE TO <your_monitoring_user>;
GRANT SELECT ON APPS.WF_DEFERRED TO <your_monitoring_user>;
GRANT SELECT ON APPS.WF_NOTIFICATION_IN TO <your_monitoring_user>;
GRANT SELECT ON APPS.WF_NOTIFICATION_OUT TO <your_monitoring_user>;

Conecte-se ao banco de dados que contém o esquema EBS como usuário SYSTEM e execute a seguinte concessão:

GRANT INHERIT PRIVILEGES ON USER <your_monitoring_user> TO APPS

Além disso, conecte-se como usuário com privilégios SYSDBA e execute o seguinte:

SQL> GRANT CREATE SESSION TO <your_monitoring_user>

Por exemplo:

SQL> GRANT CREATE SESSION TO C##STACKMONITOR

Se alguma das subvenções estiver ausente, o impacto é descrito da seguinte forma:

Entrada de Descoberta do E-Business

Descobrir Banco de Dados PeopleSoft

O Oracle Database que contém o esquema PeopleSoft (PSFT) deve ser descoberto antes de descobrir o aplicativo PeopleSoft. Se o banco de dados for descoberto primeiro, ele será associado automaticamente ao aplicativo PeopleSoft depois que a descoberta do recurso PeopleSoft for concluída

Se a descoberta do aplicativo PeopleSoft for executada antes de o banco de dados ter sido descoberto, a associação precisará ser criada manualmente. Consulte Topologia do Aplicativo para obter mais informações.

Para Descobrir o Oracle Database, consulte Oracle Database.

Privilégios de Concessão do BD para Monitoramento PeopleSoft

O monitoramento do PeopleSoft (PSFT) requer privilégios específicos para acessar o esquema do banco de dados do PSFT. A configuração difere dependendo do tipo de banco de dados (Banco de Dados Não Contêiner versus Banco de Dados Contêiner e Banco de Dados Plugável) usado como seu armazenamento de dados PSFT. O Stack Monitoring suporta o uso do proprietário do esquema PSFT, geralmente SYSADM, como as credenciais do banco de dados ao descobrir o PSFT. É preferível criar um usuário de monitoramento com apenas os privilégios necessários para monitorar um aplicativo PSFT. Você pode usar o mesmo usuário do banco de dados para monitorar o banco de dados Oracle que contém o esquema PeopleSoft e o aplicativo PeopleSoft. As etapas para criar um usuário de monitoramento de banco de dados podem ser encontradas na Observação do MOS: 2857604.1.

Para verificar se o usuário de monitoramento tem as concessões necessárias e aplicar as concessões ausentes:

1. Certifique-se de que o usuário de monitoramento não tenha expirado:
   1. Verifique o status do usuário de monitoramento executando o seguinte:

      select username, account_status from dba_users where username='<your_monitoring_user>'

   2. Se o usuário de monitoramento mostrar EXPIRADO, redefina sua senha.
2. Execute os seguintes PeopleSoft Scripts.

Para entender as concessões específicas a serem aplicadas ou aplicar manualmente as concessões, consulte a lista de comandos abaixo a serem executados.

Privilégios de Banco de Dados

• PeopleSoft Concessões de Aplicativo

  GRANT SELECT ON SYSADM.PSSTATUS TO <your_monitoring_user>;
  GRANT SELECT ON SYSADM.PSRELEASE TO <your_monitoring_user>;
  GRANT SELECT ON SYSADM.PSPMAGENT TO <your_monitoring_user>;

• PeopleSoft Sinônimos do Aplicativo

  CREATE OR REPLACE SYNONYM <your_monitoring_user>.PSSTATUS FOR SYSADM.PSSTATUS;
  CREATE OR REPLACE SYNONYM <your_monitoring_user>.PSRELEASE FOR SYSADM.PSRELEASE;
  CREATE OR REPLACE SYNONYM <your_monitoring_user>.PSPMAGENT FOR SYSADM.PSPMAGENT;

• Concessões do mecanismo de pesquisa

  Observação
  
  O Mecanismo de Pesquisa suporta Elasticsearch e OpenSearch.

  GRANT SELECT ON SYSADM.PS_PTSF_SRCH_ENGN TO <your_monitoring_user>;

• Sinônimos do mecanismo de pesquisa

  Observação
  
  O Mecanismo de Pesquisa suporta Elasticsearch e OpenSearch.

  CREATE OR REPLACE SYNONYM <your_monitoring_user>.PS_PTSF_SRCH_ENGN FOR SYSADM.PS_PTSF_SRCH_ENGN

• Concessões do Monitor de Processo

  GRANT SELECT ON SYSADM.PSPRCSRQST TO <your_monitoring_user>;
  GRANT SELECT ON SYSADM.PSXLATITEM TO <your_monitoring_user>;

• Sinônimos do Monitor de Processo

  CREATE OR REPLACE SYNONYM <your_monitoring_user>.PSPRCSRQST FOR SYSADM.PSPRCSRQST;
  CREATE OR REPLACE SYNONYM <your_monitoring_user>.PSXLATITEM FOR SYSADM.PSXLATITEM;

Ativar o PeopleSoft Performance Monitor para PIA (Pure Internet Architecture)

1. Navegue até PeopleTools, vá para Perfil da Web, clique em Configuração do Perfil da Web e procure o perfil em uso, por exemplo, PROD.
2. Se ainda não estiver marcada, marque a caixa de seleção Ativar Agente PPM.
3. Reinicie todos os domínios PIA.

Pré-requisitos para o Servidor de Aplicativos e Domínios do Process Scheduler

Ativar o PeopleSoft Performance Monitor Agent

1. Usando a interface de linha de comando PSADMIN, selecione Servidor de Aplicativos (Opção 1) ou Process Scheduler (Opção 2) > Administrar um domínio (Opção 1) > selecionar domínio > Editar menu de arquivos de configuração/log (opção 6) > Editar arquivo de configuração de domínio (Opção 1), isso abrirá os arquivos de configuração de domínio no modo de edição

2. na seção PSTOOLS, verifique o valor do EnablePPM Agent. Para Ativar Agentes PPM, defina o valor como 1 e salve o arquivo.

Ativar Agentes JMX

Esse pré-requisito permite que o Stack Monitoring colete dados de disponibilidade e desempenho para um aplicativo PeopleSoft.

1. Usando a interface de linha de comando PSADMIN, selecione Servidor de Aplicativos (Opção 1) ou Process Scheduler (Opção 2) > Administrar um domínio (Opção 1) > selecionar domínio > Editar menu de arquivos de configuração/log (opção 6) > Editar arquivo de configuração de domínio (Opção 1), isso abrirá os arquivos de configuração de domínio no modo de edição

2. Localize a seção configurações para PSTOOLS e defina os valores abaixo

   1. Certifique-se de que a Porta de Administração Remota que você pretende usar não esteja sendo utilizada por nenhum outro processo no host.

   2. UserID

      • UserId deve estar no formato de texto.

      • O mesmo UserId e a mesma senha devem ser usados para todos os domínios do servidor de aplicativos e domínios do Process Scheduler.

   3. Use o utilitário PSCipher para criptografar a senha.
   4. Reinicie o servidor de Aplicativos e os domínios do Process Scheduler depois de configurar a alteração de propriedade do Performance Collator abaixo.

3. • Para o PSFT versão 8.59 e anterior, somente a Porta de Administração Remota precisa ser definida. O valor da porta RMI será definido automaticamente com base no valor da Porta de Administração Remota incrementado em 1. Por exemplo, se a Porta de Administração Remota for 10100, a porta 10101 será usada para o servidor RMI da PHC. Quando você planeja o uso da porta, isso precisa ser levado em consideração. Uma vez que 10101 é escolhido automaticamente no exemplo acima, se essa porta não é livre PSFT automaticamente escolhe qualquer outra porta livre aleatória. Certifique-se de revisar o arquivo de configuração do domínio depois que a configuração tiver sido salva com sucesso e use essas portas para se conectar na descoberta.

     Por exemplo:

     Enable Remote Administration=1
     Remote Administration Port=10100
     Remote Administration UserId=<the userid you have defined in step 2b>
     Remote Administration Password={V2.1}<encrypted password>

   • Para o PSFT versão 8.60 em diante, a porta RMI é controlada por um parâmetro adicional no arquivo de configuração. Certifique-se de que o valor esteja definido explicitamente. Reinicie o servidor de Aplicativos e os domínios do Process Scheduler depois de configurar a propriedade Performance Collator.

     Por exemplo:

     Enable Remote Administration=1
     Remote Administration Port=10100
     Remote Administration RMI Server Port=10101
     Remote Administration UserId=<the userid you have defined in step 2b>
     Remote Administration Password={V2.1}<encrypted password>

   Observação
   
   Certifique-se de que a definição salva acima seja mostrada corretamente no arquivo de configuração após as alterações serem salvas.

Ativar a Propriedade do Colador de Desempenho

Você pode verificar o valor atual do Comparador de desempenho nos arquivos de modelo de domínio psprcsrv.ubx (Process scheduler) e psappsrv.ubx (Application Server) localizados em $PS_CFG_HOME

Se o Comparador de Desempenho estiver ativado, você verá a entrada como abaixo.

{PPM} Do you want Performance Collators configured (PSPPMSRV) (y/n)? [y]:

Se o Comparador de desempenho estiver desativado, você verá a entrada como abaixo.

{PPM} Do you want Performance Collators configured (PSPPMSRV) (y/n)? [n]:

Se o Performance Collator já estiver ativado, e as alterações tiverem sido implementadas nos valores de Agente ou JMX EnablePPM: Reinicie todos os domínios.

Se o Agrupador de Desempenho não já estiver ativado, prossiga com as seguintes etapas:

1. Usando a interface de linha de comando PSADMIN, selecione Servidor de Aplicativos (Opção 1) ou Process Scheduler (Opção 2) > Administrar um domínio (Opção 1) > selecionar domínio > Configurar este domínio (Opção 4)
2. Digite y para a pergunta: Do you want to continue (y/n). Esta opção encerrará o domínio

3. Verifique o valor da propriedade Perf Collator.

4. Se o valor definido como Yes, o Collator já estiver ativado, nenhuma ação será necessária. Em seguida, selecione Carregar configuração conforme mostrado (Opção 14 para Servidor de Aplicativos ou Opção 7 para Process Scheduler)

5. Se o valor for definido como No, digite 10 para o servidor de Aplicativos ou Opção 3 para que o Process Scheduler alterne o valor para Yes

6. Depois de confirmar o Conjunto de Garantias de Desempenho como Yes, selecione Carregar configuração, conforme mostrado (Opção 14 para o Programador de Aplicativos ou Opção 7 para o Process Scheduler )

7. Por fim, selecione Inicializar este domínio Opção 1 para iniciar o domínio

Identificar Domínios a Serem Descobertos

O Stack Monitoring aproveita as informações armazenadas no Oracle Database para identificar domínios a serem descobertos ou atualizados. Para validar a lista de domínios atuais, execute a consulta a seguir.

SELECT * FROM PSPMAGENT;

Todos os domínios retornados pela consulta que não existem mais devem ser removidos antes de descobrir/atualizar o Aplicativo PeopleSoft.

Para adicionar um domínio que não esteja listado, consulte Adicionando domínios manualmente.

Para remover os domínios desatualizados, execute o SQL a seguir como SYSADM ou usuário equivalente. Repita as etapas até que todos os domínios desatualizados sejam removidos.

• Faça backup da tabela PSPMAGENT antes de fazer alterações. Certifique-se de substituir <DATE> pelo timestamp atual.

  create table PSPMAGENT_BKP_<DATE> as select * from PSPMAGENT;

• Verifique se a tabela de backup criada tem o mesmo conteúdo da tabela pai.

  select * from PSPMAGENT
  MINUS
  select * from PSPMAGENT_BKP_<DATE>;

Se a contagem de linhas de PSPMAGENT corresponder a PSPMAGENT_BKP_<DATE>, prossiga com a remoção de domínios desatualizados.

delete from PSPMAGENT WHERE PM_AGENTID='&enter_agent_id_of_stale_domain';
Commit;

Adicionando domínios manualmente

Por fim, verifique se todos os domínios válidos estão visíveis na tabela PSPMAGENT. Se algum domínio válido não aparecer por qualquer motivo, siga as instruções abaixo:

Criar um backup:

1. Como administrador do sistema ou usuário equivalente, faça um backup da tabela antes de fazer alterações. Certifique-se de substituir <DATE> pelo carimbo de data/hora atual:

   create table PSPMAGENT_BKP_<DATE> as select * from PSPMAGENT;

2. Verifique se a tabela de backup criada tem o mesmo conteúdo da tabela pai. A contagem de linhas de PSPMAGENT deve corresponder à contagem de linhas de PSPMAGENT_BKP_<DATE>:

   select * from PSPMAGENT
   MINUS
   select * from PSPMAGENT_BKP_<DATE>;

Adicionar um Domínio do Process Scheduler

INSERT INTO  PSPMAGENT values
('&AGENT_ID','&PM_JMX_RMI_PORT','PSMONITORSRV','&DOMAIN_NAME','04','&DOMAIN_DIR','Y','&HOST_PORT:','1','1','N');

Por exemplo:

SQL>  INSERT INTO  PSPMAGENT values
('&AGENT_ID','&PM_JMX_RMI_PORT','PSMONITORSRV','&DOMAIN_NAME','04','&DOMAIN_DIR','Y','&HOST_PORT:','1','1','N');  2 
Enter value for unique_agent_id: 1000
Enter value for pm_jmx_rmi_port: 10500
Enter value for domain_name: PRCSDOM02
Enter value for domain_dir: /u01/app/oracle/product/psfthcm-midtierlinux-2/ps_cfg_home/appserv/prcs/PRCSDOM02
Enter value for host_name: psfthcm-midtierlinux-2
old   2: ('&unique_agent_id','&PM_JMX_RMI_PORT','PSMONITORSRV','&DOMAIN_NAME','04','&domain_dir','Y','&host_name:','1','1','N')
new   2: ('1000','10500','PSMONITORSRV','PRCSDOM02','04','/u01/app/oracle/product/psfthcm-midtierlinux-2/ps_cfg_home/appserv/prcs/PRCSDOM02','Y','psfthcm-midtierlinux-2:','1','1','N')
  
1 row created.

Adicionar um Domínio do Servidor de Aplicativos

INSERT INTO  PSPMAGENT values
('&unique_agent_id','&JMX_RMI_PORT','PSMONITORSRV','&DOMAIN_NAME','01','&DOMAIN_DIR','Y','&host_name:&jolt_port','1','1','N');

Por exemplo:

SQL> INSERT INTO  PSPMAGENT values
('&unique_agent_id','&JMX_RMI_PORT','PSMONITORSRV','&DOMAIN_NAME','01','&DOMAIN_DIR','Y','&host_name:&jolt_port','1','1','N');   2 
Enter value for unique_agent_id: 1003
Enter value for jmx_rmi_port: 10500
Enter value for domain_name: APPDOM4
Enter value for domain_dir: /u01/app/oracle/product/psfthcm-midtierlinux-3/ps_cfg_home/appserv/APPDOM04
Enter value for host_name: psfthcm-midtierlinux-3
Enter value for jolt_port: 9033
old   2: ('&unique_agent_id','&JMX_RMI_PORT','PSMONITORSRV','&DOMAIN_NAME','01','&DOMAIN_DIR','Y','&host_name:&jolt_port','1','1','N')
new   2: ('1003','10500','PSMONITORSRV','APPDOM4','01','/u01/app/oracle/product/psfthcm-midtierlinux-3/ps_cfg_home/appserv/APPDOM04','Y','psfthcm-midtierlinux-3:9033','1','1','N')

Adicionar um Servidor PIA

INSERT INTO  PSPMAGENT values
('&unique_agent_id','-1','WEBRESOURCE','&DOMAIN_NAME','02','&DOMAIN_DIR','Y','&host_name:&http_port:&https_port','1','1','N');

Por exemplo:

INSERT INTO  PSPMAGENT values
('&unique_agent_id','-1','WEBRESOURCE','&DOMAIN_NAME','02','&DOMAIN_DIR','Y','&host_name:&http_port:&https_port','1','1','N');
Enter value for unique_agent_id: 19
Enter value for domain_name: peoplesoft03
Enter value for domain_dir: /u01/app/oracle/product/psfthcm-midtierlinux-3/ps_cfg_home/webserv/WEBSERVER/peoplesoft03
Enter value for host_name: psfthcm-midtierlinux-3
Enter value for http_port: 9000
Enter value for https_port: 9001
old   2: ('&unique_agent_id','-1','WEBRESOURCE','&DOMAIN_NAME','02','&DOMAIN_DIR','Y','&host_name:&http_port:&https_port','1','1','N')
new   2: ('19','-1','WEBRESOURCE','peoplesoft03','02','/u01/app/oracle/product/psfthcm-midtierlinux-3/ps_cfg_home/webserv/WEBSERVER/peoplesoft03','Y','psfthcm-midtierlinux-3:9000:9001','1','1','N')
  
1 row created.

Ativar descoberta do Mecanismo de Pesquisa em PeopleSoft

A descoberta do Mecanismo de Pesquisa é opcional e suporta Elasticsearch e OpenSearch. Se o Mecanismo de Pesquisa já estiver integrado, você poderá incluí-lo na descoberta inicial. Para integrar o Mecanismo de Pesquisa no futuro, use o comando refresh da CLI PeopleSoft e adicione as concessões do BD do Mecanismo de Pesquisa ao usuário de monitoramento. Para obter mais informações sobre concessões, consulte Privilégios de Concessão de BD para Monitoramento de PeopleSoft e para obter mais informações sobre comandos de atualização da CLI, consulte PeopleSoft Atualizar.

grep JAVA_HOME emd.properties
JAVA_HOME=/var/lib/oracle-cloud-agent/plugins/oci-managementagent/polaris/jdk1.8.0_371-b11

Esses pré-requisitos ativam a Integração do Mecanismo de Pesquisa em PeopleSoft:

• O Stack Monitoring só suporta o mecanismo de pesquisa de monitoramento configurado com SSL. Seu ponto final deve ser HTTPS. Para obter mais informações sobre a configuração, consulte Configurando SSL para Elasticsearch ou Configurando SSL para OpenSearch, respectivamente.

• Antes de descobrir o Mecanismo de Pesquisa, crie um armazenamento confiável JKS, pois o JKS é o único tipo suportado de armazenamento confiável no host do agente de monitoramento para armazenar o certificado do Mecanismo de Pesquisa. A localização e a senha desse armazenamento confiável são parâmetros obrigatórios na IU de descoberta ou no JSON de descoberta ao executar a descoberta por meio da CLI, enquanto o local do armazenamento confiável deve estar acessível no host do agente.

  Por exemplo:

  keytool -keystore truststore.jks -alias <ALIAS> -import -file <SEARCH ENGINE CERTIFICATE>

Ativar descoberta do Process Monitor para PeopleSoft

• O Process Monitor é descoberto ao lado de PeopleSoft e ativado por padrão ao descobrir um Aplicativo PeopleSoft. A seleção de Não na seção Descobrir Monitor de Processo não incluirá o Process Monitor na descoberta PeopleSoft.
• A descoberta do Process Monitor é opcional. Se o Process Monitor já estiver ativado, você poderá incluí-lo na descoberta inicial. Para integrar o Process Monitor no futuro, use o comando PeopleSoft CLI refresh e adicione as concessões do Banco de Dados do Process Monitor ao usuário de monitoramento. Para obter mais informações sobre concessões, consulte Privilégios de Concessão de BD para Monitoramento de PeopleSoft e para obter mais informações sobre comandos de atualização da CLI, consulte PeopleSoft Atualizar.

• Não há propriedades necessárias para a descoberta do Process Monitor

• Interface do Usuário

  • A descoberta do Process Monitor é incluída por padrão. Para recusar, selecione Não em Descobrir Monitor de Processo no painel Descoberta de recursos.

Pré-requisitos

• Ative o monitoramento de JMX. Consulte Ativando Remoto de JMX.
  Observação
  
  O monitoramento do Tomcat não suporta SSL. O SSL será desativado por padrão ao seguir a documentação do Tomcat.

Entrada de Descoberta do Apache Tomcat

Para obter mais informações sobre parâmetros de entrada, consulte Parâmetros de Entrada JSON

Pré-requisitos

Criar um Usuário de Banco de Dados Personalizado

Para ativar o monitoramento de um Banco de Dados do Microsoft SQL Server, você pode criar um usuário de banco de dados especial da seguinte forma:

Crie um usuário (por exemplo, monstk) e mapeie o novo usuário para os bancos de dados mestre e msdb. Em seguida, conceda a este usuário os privilégios mínimos a seguir.

CREATE LOGIN monstk
WITH PASSWORD = 'monstk1;123';
GO
CREATE USER monstk FOR LOGIN monstk;
GO

Mapeie o usuário para todos os bancos de dados do sistema e do usuário:

USE master;
CREATE USER monstk FOR LOGIN monstk;
GRANT VIEW ANY DATABASE TO monstk;
GRANT VIEW ANY definition TO monstk;
GRANT VIEW server STATE TO monstk;

GRANT EXECUTE ON sp_helplogins TO monstk;
GRANT EXECUTE ON sp_readErrorLog TO monstk;
GRANT EXECUTE ON dbo.xp_regread TO monstk;

GRANT CREATE FUNCTION TO [monstk];
GRANT CONTROL TO [monstk];
GRANT CREATE TABLE TO [monstk];
GRANT SELECT ON [sys].[sysaltfiles] TO [monstk];

USE msdb;
GRANT SELECT ON dbo.sysjobsteps TO monstk;
GRANT SELECT ON dbo.sysjobs TO monstk;
GRANT SELECT ON dbo.sysjobhistory TO monstk;

Entrada de Descoberta do MS SQL Server

Pré-requisitos

WebLogic precisa ser descoberto antes da descoberta do MFT (Managed File Transfer). Ao descobrir o MFT, na IU de descoberta, selecione o WebLogic correspondente na lista drop-down.

Requisitos do Serviço Database Monitoring para o Stack Monitoring

O banco de dados Oracle deve ser descoberto antes de descobrir o aplicativo MFT. Se o banco de dados for descoberto primeiro, ele será associado automaticamente ao aplicativo MFT depois que a descoberta do aplicativo MFT for concluída. Se a descoberta do aplicativo MFT for executada antes da descoberta do banco de dados, a associação precisará ser criada manualmente. Consulte Atualizando Topologia do Aplicativo para obter mais informações.

O monitoramento de um aplicativo Managed File Transfer requer privilégios específicos para acessar o esquema MFT. O Stack Monitoring suporta o uso do proprietário do esquema MFT, geralmente DEV_MFT, como as credenciais do banco de dados ao descobrir o MFT. É preferível criar um usuário de monitoramento com apenas os privilégios necessários para monitorar um aplicativo MFT. Você pode usar o mesmo usuário do banco de dados para monitorar o banco de dados Oracle que contém o esquema MFT e o aplicativo MFT. As etapas para criar um usuário de monitoramento de banco de dados podem ser encontradas na Observação do MOS: 2857604.1.

Os privilégios específicos são definidos no código abaixo. Ele assume o nome do esquema MFT de DEV_MFT. Se o nome do esquema for diferente em sua configuração, substitua DEV_MFT pelo nome do esquema real no código a seguir. Substitua <user> pelo usuário de monitoramento do banco de dados criado usando o script. Certifique-se de que as concessões sejam aplicadas ao usuário de monitoramento criado no local em que o esquema DEV_MFT reside.

Permissões do Banco de Dados:

GRANT SELECT ON DEV_MFT.MV_MFT_SOURCE_MESSAGE TO <your_monitoring_user>;
GRANT SELECT ON DEV_MFT.MV_MFT_TARGET_INFO TO <your_monitoring_user>;
GRANT SELECT ON DEV_MFT.MV_MFT_TRANSFER_COUNT_INFO TO <your_monitoring_user>;
GRANT SELECT ON DEV_MFT.MV_MFT_SOURCE_INFO TO <your_monitoring_user>;
GRANT SELECT ON DEV_MFT.MV_MFT_TRANSFER TO <your_monitoring_user>;

Entrada da Descoberta

OHS Colocado

A Descoberta OHS Collocalizada faz parte da Descoberta do Domínio do Weblogic e todos os seus pré-requisitos se aplicam.

Para obter mais informações sobre a instalação do OHS colocado, consulte Sobre a Instalação do Oracle HTTP Server.

OHS Independente

Versões suportadas:

• versão 11.x - somente monitoramento local, host Linux, ferramenta OPMN usada para coleta de métricas.

• versão 12.x - somente monitoramento local, host Linux, ferramenta WLST usada para coleta de métricas

Pré-requisitos:

• O Management Agent deve ser instalado no mesmo host que o Oracle HTTP Server stand-alone.

• O arquivo de configuração do OHS (httpd.conf) deve estar acessível e legível pelo usuário de instalação do Management Agent (mgmt_agent para agente stand-alone e oracle-cloud-agent para o Oracle Cloud Agent).

OHS versão 11.x:

A versão 11.x OHS coleta métricas usando a ferramenta OPMN.

OHS versão 12.x:

1. Permissões de leitura para o usuário Agente no arquivo httpd.conf em:

   <PATH>/user_projects/domains/<domain_name>/config/fmwconfig/components/OHS/<COMP_NAME>/httpd.conf

   Exemplo :

   <PATH>/user_projects/domains/ohs_domain/config/fmwconfig/components/OHS/ohs1

   Execute o seguinte comando para fornecer acesso de leitura:

   sudo chmod 640 <PATH>/user_projects/domains/<domain_name>/config/fmwconfig/components/OHS/<COMP_NAME>/httpd.conf

2. Permissões de leitura para o usuário Agente no arquivo de armazenamento de chaves Java do OHS em:

   <ORACLE HOME DIRECTORY>/wlserver/server/lib/DemoTrust.jks (Arquivo jks personalizado caso o uso de certificados personalizados)

   Por exemplo:

   sudo chmod 640 <absolute path to <Oracle Home directory>/wlserver/server/lib/DemoTrust.jks

3. Permissões de Leitura e Execução em <ORACLE HOME DIRECTORY>/oracle_common/common/bin/wlst.sh

Entrada de Descoberta do OHS versão 11.x

Entrada de Descoberta do OHS versão 12.x

Pré-requisitos

• O Management Agent deve ser instalado no mesmo host que o Apache HTTP Server.
• Ative o módulo mod_status Apache (https://httpd.apache.org/docs/2.4/mod/mod_status.html). Configure a diretiva de local /server-status para o Nome do Host e a Porta especificados.

  Por exemplo:

  http(s)://<hostname>:<port>/server-status

• Ative ON a diretiva ExtendedStatus (https://httpd.apache.org/docs/2.4/mod/core.html#extendedstatus).
• Se aplicável, forneça controle de acesso à diretiva de local /server-status configurada para que as solicitações HTTP/HTTPS possam ser feitas com sucesso no host no qual o Agente está instalado. O Agente só suporta a Autenticação Básica com uma conexão HTTPS se necessário. Para obter mais informações sobre como configurar o controle de acesso adicional, consulte Documentação, Autenticação e Autorização do Apache.

• Os arquivos binários do Apache devem estar acessíveis e ser executáveis pelo usuário de instalação do Management Agent:

  • O(s) arquivo(s) *.conf do Apache, incluindo o arquivo httpd.conf, devem estar acessíveis e legíveis pelo usuário de instalação do Management Agent (mgmt_agent para agente stand-alone e oracle-cloud-agent para o Oracle Cloud Agent).
  • O arquivo binário do Apache (httpd) deve estar acessível e ser executável pelo usuário de instalação do Management Agent (mgmt_agent para agente stand-alone e oracle-cloud-agent para o Oracle Cloud Agent).
  • O arquivo pid do Apache (httpd.pid) deve estar acessível e legível pelo usuário de instalação do Management Agent (mgmt_agent para agente stand-alone e oracle-cloud-agent para o Oracle Cloud Agent)..

Veja um exemplo de como adicionar todas as permissões necessárias para o usuário do agente de gerenciamento criando um grupo de usuários administrador de apache dedicado e adicionando o usuário do agente de gerenciamento a ele:

#Create a user group for apache administration
groupadd apache_admin_grp
 
#Add management agent user to the apache admin group
#for user installed management agent
usermod -G apache_admin_grp mgmt_agent
#for oracle cloud agent plugin
usermod -G apache_admin_grp oracle-cloud-agent
 
#Change ownership for apache server root directory and binary file. Example:
chown -R root:apache_admin_grp /etc/httpd
chmod -R 770 /etc/httpd
 
chown -R root:apache_admin_grp /usr/sbin/httpd
chmod -R 770 /usr/sbin/httpd
 
#Grant access to httpd.pid file. Example:
chown -R root:apache_admin_grp /run/httpd
 
#Restart the Agent for the user group assignment to take effect.
#for user installed management agent
systemctl restart mgmt_agent
#for oracle cloud agent plugin
systemctl restart oracle-cloud-agent

Entrada de Descoberta do Apache HTTP Server

Configurar Exportador

O exportador coletará métricas do OUD e criará um ponto final para expor as métricas no formato Prometheus. Essas métricas serão submetidas a upload pelo agente de gerenciamento para o armazenamento de dados de telemetria para o <specified name space>.

O exportador precisa ser configurado para cada instância de cada modo de instalação. Por exemplo, se houver 3 diretórios e 2 proxies, o exportador terá que ser configurado 5 vezes.

Visão geral das etapas de configuração:

1. Certifique-se de que o Python esteja instalado e também instale o python-ldap
2. Adicionar o grupo de runtime do usuário do OUD ao usuário mgmt_agent
3. Copiar o script do exportador para um local personalizado
4. Criar arquivos de senha temporários para o exportador do OUD
5. Criar um usuário de monitoramento para a instância do OUD
6. Conceda concessões do sistema de arquivos ao banco de dados OUD para monitorar os tamanhos do banco de dados
7. Configurar exportador OUD
8. Ativar exportador do OUD para iniciar após uma reinicialização do SO
9. Confirmar se as métricas estão fluindo

Etapas de configuração:

1. Certifique-se de que o Python esteja instalado e também instale o python-ldap:

   • No RedHat/Oracle Linux 8 e 9:

     sudo -n yum install -y libnsl python3-ldap httpd-tools

   • No RedHat/Oracle Linux 7:

     sudo -n yum install -y libnsl python-ldap httpd-tools

2. Certifique-se de que mgmt_agent tenha as permissões certas:

   1. Adicione o grupo de runtime do usuário do OUD ao usuário mgmt_agent:

      sudo usermod -G <OUD_USER_GROUP> mgmt_agent

   2. Certifique-se de que o diretório <ORACLE_HOME> e seus diretórios pai tenham permissões de execução:

      sudo chmod -R 0750 <ORACLE_HOME_PATH>

3. Copie o script do exportador para um local personalizado:

   1. Crie um diretório personalizado no qual o exportador do OUD será executado.
   2. Altere a propriedade do novo diretório e conceda acesso de leitura e execução ao usuário mgmt_agent para esse novo diretório e todo o conteúdo nele:

      sudo chown -R mgmt_agent:mgmt_agent <CUSTOM_EXPORTER_DIRECTORY_PATH>

      Por exemplo:

      sudo chown -R mgmt_agent:mgmt_agent /scratch/exporter/oud_exporter

   3. Como usuário do agente de gerenciamento, copie o script manage_exporter.sh de $AGENT_INST/config/destinations/OCI/services/appmgmt/<Latest_Version>/scripts/oud para o diretório personalizado.

4. Crie arquivos de senha temporários para o exportador do OUD:

   1. Para o usuário do diretório raiz, como cn=Directory Manager:

      echo <PASSWORD> | sudo -u mgmt_agent tee
            <FULL_PATH_OF_THE_DIRECTORY_MANAGER_USER_PASSWORD_FILE>/.pw

      Por exemplo:

      echo <password> | sudo -u mgmt_agent tee /scratch/exporter/oud_exporter/.pw

   2. Para o usuário de monitoramento:

      echo <PASSWORD> | sudo -u mgmt_agent tee <FULL_PATH_OF_THE_MONITORING_USER_PASSWORD_FILE>/.mpw

      Por exemplo:

      echo <password> | sudo -u mgmt_agent tee /scratch/exporter/oud_exporter/.mpw

5. Crie um usuário de monitoramento para a instância do OUD:

   1. Como usuário mgmt_agent, execute:

      ./manage_exporter.sh adduser --port <ADMINISTRATION_PORT_OF_THE_OUD_INSTANCE> --utype admin --dstype oud -j <FULL_PATH_OF_THE_DIRECTORY_MANAGER_USER_PASSWORD_FILE> --mpw <FULL_PATH_OF_THE_MONITORING_USER_PASSWORD_FILE> --javaHome <JAVA_HOME_PATH>

      Por exemplo:

      ./manage_exporter.sh adduser --port 4444 --utype admin --dstype oud -j /scratch/exporter/oud_exporter/.pw --mpw /scratch/exporter/oud_exporter/.mpw --javaHome /scratch/install/jdk1.8.0_381/

   2. Por padrão, o nome do Usuário de Monitoramento é muser. Ele pode ser alterado com --muser <name>

6. Conceda concessões do sistema de arquivos ao banco de dados OUD para monitorar os tamanhos do banco de dados:

   1. sudo getfacl "<OUD_HOME_DIRECTORY_PATH>/OUD/db"

      Por exemplo:

      sudo getfacl "/scratch/oud12c/oud_instance/OUD/db"

   2. sudo setfacl -R -m "u:mgmt_agent:rx" "<OUD_HOME_DIRECTORY_PATH>/OUD/db"

      Por exemplo:

      sudo setfacl -R -m "u:mgmt_agent:rx" "/scratch/oud12c/oud_instance/OUD/db"

7. Configurar exportador OUD:

   1. Como usuário mgmt_agent, execute o comando de configuração:

      ./manage_exporter.sh setup --type <PRODUCT_TYPE> --compartment <COMPARTMENT_ID> --name <RESOURCE_NAME> --instName <RESOURCE_NAME> --ldap <LDAP_PORT> --ldaps <LDAPS_PORT> --oracleHome <ORACLE_HOME_PATH> --adminPort <ADMINISTRATION_PORT_OF_THE_OUD_INSTANCE> --metricPort <METRICS_MONITORING_ENDPOINT_PORT> --javaHome <JAVA_HOME_PATH> -D <NAME_OF_THE_MONITORING USER> -j <FULL_PATH_OF_THE_DIRECTORY_MANAGER_USER_PASSWORD_FILE> 

      Por exemplo:

      ./manage_exporter.sh setup --type oud --compartment ocid.compartment1.abcdef1234 --name oud_one --instName oud_one --ldap 0 --ldaps 0 --oracleHome /scratch/oud12c --adminPort 4444 --metricPort 1888 --javaHome /scratch/install/jdk1.8.0_381/ -D muser -j /scratch/exporter/oud_exporter/.pw

   2. Reiniciar agente de gerenciamento:

      sudo systemctl restart mgmt_agent

   3. Para obter mais opções durante a configuração, execute o comando de ajuda:

      ./manage_exporter.sh help

   As métricas do OUD serão coletadas no formato Prometheus no ponto final do Promethus, e o agente de gerenciamento também fará upload das métricas para telemetria.

8. Ative o exportador do OUD para iniciar após uma reinicialização do SO. Isso também permitirá que o usuário mgmt_agent reinicie o Management Agent e os serviços do Exportador:

   sudo ./manage_exporter.sh enable

9. Confirme se as métricas estão fluindo:

   1. Para garantir que o exportador esteja coletando as métricas do OUD corretamente, chame o ponto final da métrica no host em que o exportador está sendo executado. É preciso haver pelo menos 40 métricas:

      1. Em um browser: as credenciais https://localhost:<METRICS_MONITORING_ENDPOINT_PORT>/metrics - node_exporter devem ser fornecidas.

         Exemplo:

         https://localhost:1888/metrics

      2. No terminal:

         curl -u "<NODE_EXPORTER_USER>:<NODE_EXPORTER_PASSWORD>" -sk https://127.0.0.1:1888/metrics

   2. Para garantir que o Management Agent esteja fazendo upload de métricas para a Telemetria, após 5 minutos desde o início do Exportador, abra o Explorador de Métricas no OCI. Selecione seu compartimento, namespace de métricas oracle_appmgmt e qualquer um dos grupos de recursos oud. Selecione qualquer métrica e verifique se ela está reportando corretamente.

Configurar opções de comando do exportador:

Status OUD

O OUD suporta 4 status diferentes, dependendo de vários fatores, que são descritos abaixo:

• Ativo

  O OUD está Ativo quando todo o sistema e as métricas estão fluindo normalmente.

• Desativado

  O OUD está Inativo quando BindDN está ausente, há um problema de conexão com o servidor LDAP ou o servidor LDAP está inativo.

• Manutenção

  Os usuários podem colocar o OUD em Manutenção a qualquer momento para executar a manutenção nas instâncias ou em qualquer outra finalidade.

• Advertência

  A instância do OUD falhou em pelo menos um teste de serviço e, portanto, deve ser investigada.

Gerenciando o status do OUD

Para configurar uma instância do OUD para estar em Manutenção ou Ativo, execute:

./manage_exporter.sh modstate <STATUS>  --port <ADMINISTRATION_PORT_OF_THE_OUD_INSTANCE> --dstype oud -j <FULL_PATH_OF_THE_DIRECTORY_MANAGER_USER_PASSWORD_FILE>

Para ver o estado atual do OUD, execute:

./manage_exporter.sh showstate --port <ADMINISTRATION_PORT_OF_THE_OUD_INSTANCE> --dstype oud -j <FULL_PATH_OF_THE_DIRECTORY_MANAGER_USER_PASSWORD_FILE>

Importar OUD

O OUD pode ser importado e monitorado de forma independente como um dos seguintes tipos de recursos:

• Servidor de Diretórios do OUD
• Servidor Proxy do OUD
• Gateway de Replicação do OUD

Importe tipos de recursos do OUD com o seguinte comando:

oci stack-monitoring resource-task import-telemetry-resources --compartment-id <compartment id> --namespace oracle_appmgmt --source OCI_TELEMETRY_PROMETHEUS --resource-group <resource group>

Importe cada tipo de recurso, não cada instância. Por exemplo, se houver 3 diretórios e 2 proxies, execute o comando import 2 vezes, uma vez para cada tipo.

Depois que os recursos forem importados, se uma nova instância do OUD for adicionada, execute o comando de importação novamente para o tipo de recurso recém-adicionado.

Pré-requisitos

As APIs REST do Oracle GoldenGate devem estar acessíveis no Management Agent, que monitorará a instância GoldenGate.

Somente o protocolo https é suportado; portanto, a instância GoldenGate deve ser configurada com os certificados necessários.

O Management Agent deve ter acesso ao arquivo JKS do Armazenamento Confiável que contém o certificado para validar a conexão TLS.

GoldenGate Entrada da Descoberta

Pré-requisitos

O IIS de monitoramento do Management Agent deve ser implantado localmente no host em que o IIS está sendo executado e os pré-requisitos necessários concluídos. Para obter mais informações, consulte Executar Pré-requisitos para a Implantação de Management Agents.

O Microsoft IIS e o Agente Local estão em execução durante a descoberta.

Entrada de Descoberta do Microsoft IIS

Pré-requisitos

• O monitoramento JMX deve ser ativado. Para ativar o monitoramento JMX, consulte Ativando o JMX Remote.

Entrada de Descoberta de Runtime do Oracle JVM

Entrada de Descoberta NGINX