Para configurar o recurso Monitoramento de Disponibilidade, crie um monitor para monitorar a disponibilidade e o desempenho do seu aplicativo entre localizações geográficas e envie métricas ao Oracle Cloud Infrastructure.

1. Navegue até a página Monitoramento de Disponibilidade.
2. No painel esquerdo, verifique se a opção Monitores está selecionada.
3. No painel esquerdo, selecione o compartimento e o domínio do APM no qual você deseja criar o monitor.
4. Clique em Criar Monitor.
   O assistente Criar Monitor é exibido.
5. Na página Definição do Monitor:
   1. Nome: Informe um nome exclusivo para o monitor.

      O nome pode ter no máximo 255 caracteres alfanuméricos. Um hífen e um sublinhado são os únicos dois caracteres especiais permitidos. Por exemplo, você pode adicionar um hífen entre dois caracteres e um sublinhado no início ou no final do nome ou entre caracteres. Espaços em branco não são permitidos.

   2. Tipo: Selecione um dos seguintes tipos de monitor:
      • Browser: Testa o desempenho de um único URL carregado por um browser.
      • Browser com Script: Testa o desempenho de um workflow de transação do usuário completo registrado em um arquivo de script .side.
      • REST: Testa o desempenho de um único URL carregado por uma chamada REST.
      • REST com Script: Testa o desempenho de um workflow de transação do usuário completo registrado em um arquivo de script .js.
      • Rede: Testa a disponibilidade e o desempenho de qualquer servidor de rede ou host que seja realizado por meio de ping no host.
      • DNS: Valida e testa a disponibilidade do DNS.
      • SQL: Mede o desempenho de uma consulta SQL, permitindo que o usuário identifique quaisquer problemas de disponibilidade ou tempo de carregamento.
      • FTP: Mede o desempenho das operações FTP, permitindo que o usuário identifique quaisquer problemas de disponibilidade ou latência. Ele pega os detalhes do servidor FTP de destino como entrada e executa a operação solicitada para gerar várias métricas de tempo.
   3. Atualize os campos exibidos com base no tipo de monitor selecionado na etapa anterior:
      • Para o tipo de monitor Browser:
        1. URL Base: Especifique o URL base no qual o monitor será executado.
        2. Validações de Resposta: Opcionalmente, marque a seguinte caixa de seleção:
           • Código de Resposta: Especifique códigos de status HTTP válidos separados por vírgulas. Por exemplo: 200,401. Ele também aceita o seguinte formato: 2xx, 3xx, 4xx.
           • Verificar Conteúdo da Resposta: Adicione uma string ou REGEX para verificar a resposta esperada em cabeçalhos e corpo da resposta.
        3. Verificar Conteúdo da Resposta Opcional: Opcionalmente, adicione uma string para verificar o conteúdo da resposta esperado. Para obter detalhes, consulte Verificar Conteúdo da Resposta (Opcional).
        4. Opções: Opcionalmente, marque as seguintes caixas de seleção:
           • Verificar SSL: Selecione esta opção para verificar a validade do certificado SSL.
           • Ativar Snapshot: Selecione esta opção para ativar ou desativar o monitor para coletar capturas de tela durante a execução. Por padrão, é ativado.
           • Substituir DNS: Selecione esta opção para especificar o endereço IP para o qual o nome de domínio do destino será resolvido, em vez de usar a resolução de DNS padrão.
      • Para o tipo de monitor Browser com Scripts:
        1. Script: Selecione um arquivo de script na lista drop-down, que é preenchida com os nomes dos scripts .side que você criou.
        2. URL Base Opcional: Com base no arquivo de script .side selecionado, esse campo é preenchido com o URL base no qual o monitor deverá ser executado. Opcionalmente, você também pode especificar o URL base nesse campo.
        3. Parâmetros de Script: Se os parâmetros de script forem definidos no conteúdo do arquivo de script, eles serão exibidos nos campos Parâmetro de Script e você poderá optar por substituir os valores dos parâmetros. Observe que o valor do parâmetro não será exibido se a opção O valor é secreto for usada ao criar ou fazer upload do script.
        4. Opções: Opcionalmente, marque as seguintes caixas de seleção:
           • Verificar SSL: Selecione esta opção para verificar a validade do certificado SSL.
           • Ativar Snapshot: Selecione esta opção para ativar ou desativar o monitor para coletar capturas de tela durante a execução. Por padrão, é ativado.
           • Substituir DNS: Selecione esta opção para especificar o endereço IP para o qual o nome de domínio do destino será resolvido, em vez de usar a resolução de DNS padrão.
      • Para o tipo de monitor REST:
        1. URL Base: Especifique o URL base no qual o monitor será executado.
        2. Método de Configuração da Solicitação: Selecione um método de configuração de solicitação: GET ou POST. Para o método POST, você pode, opcionalmente, inserir as informações de payload da solicitação no campo Corpo da Solicitação.
        3. Tipo de Autenticação: Selecione um tipo de autenticação:
           • Nenhum: Selecione esta opção se nenhuma autenticação for necessária.
           • Autenticação Básica: Selecione esta opção se a autenticação básica for necessária e especifique o Nome do Usuário e a Senha.
           • Token do Portador: Selecione esta opção se a autenticação do portador for necessária e especifique o Token.
           • OAuth: Selecione esta opção se a autenticação aberta for necessária e especifique o Esquema de Autenticação e as informações nos campos exibidos com base no esquema de autenticação.
           • Chefe de Recursos: Selecione essa opção para conceder acesso e monitorar recursos do OCI, como armazenamento de objetos ou vault, sem especificar credenciais. Ele usa um grupo dinâmico e políticas que fornecem controle detalhado.
             Observação
             
             Para usar a autenticação do controlador de recursos, crie um grupo dinâmico e adicione políticas a ele para acessar os recursos na tenancy e conceder aos Monitores de Disponibilidade do APM acesso aos recursos do OCI em sua tenancy. Para obter detalhes, consulte Executar Pré-requisitos do Oracle Cloud Infrastructure.
        4. Parâmetros de Consulta Opcional: Opcionalmente, especifique os parâmetros de consulta de configuração de solicitação.
        5. Parâmetros do Cabeçalho Opcional: Opcionalmente, especifique os parâmetros do cabeçalho de configuração da solicitação.
        6. Certificado do Cliente Opcional: Opcionalmente, especifique as informações do certificado para autenticação do cliente.
           • Chave Privada: Faça upload do arquivo de chave privada.
           • Certificado: Faça upload do arquivo de certificado do cliente.
             Observação
             
             O formato PEM é suportado para a chave privada e o certificado do cliente.
        7. Validações de Resposta: Opcionalmente, marque a seguinte caixa de seleção:
           • Código de Resposta: Especifique códigos de status HTTP válidos separados por vírgulas. Por exemplo: 200,401. Ele também aceita o seguinte formato: 2xx, 3xx, 4xx.
           • Verificar Conteúdo da Resposta: Adicione uma string ou REGEX para verificar a resposta esperada em cabeçalhos e corpo da resposta.
        8. Opções: Opcionalmente, marque as seguintes caixas de seleção:
           • Verificar SSL: Selecione esta opção para verificar a validade do certificado SSL.
           • Separar Redirecionamentos: Selecione esta opção para seguir redirecionamentos.
           • Substituir DNS: Selecione esta opção para especificar o endereço IP para o qual o nome de domínio do destino será resolvido, em vez de usar a resolução de DNS padrão.
      • Para o tipo de monitor REST com script:
        1. Script: Selecione um arquivo de script na lista drop-down, que é preenchida com os nomes dos scripts .js que você criou.
        2. URL Base Opcional: Com base no arquivo de script .js selecionado, esse campo é preenchido com o URL base no qual o monitor deverá ser executado. Opcionalmente, você também pode especificar o URL base nesse campo.
        3. Parâmetros de Script: Se os parâmetros de script forem definidos no conteúdo do arquivo de script, eles serão exibidos nos campos Parâmetro de Script e você poderá optar por substituir os valores dos parâmetros. Observe que o valor do parâmetro não será exibido se a opção O valor é secreto for usada ao criar ou fazer upload do script.
        4. Autenticação: Opcionalmente, marque a seguinte caixa de seleção:
           • Chefe de Recursos: Selecione essa opção para conceder acesso e monitorar recursos do OCI, como armazenamento de objetos ou vault, sem especificar credenciais.
             Pré-requisitos: Para usar a autenticação do Controlador de Recursos, execute os seguintes pré-requisitos:

             • Políticas: Crie um grupo dinâmico e adicione políticas a ele para acessar os recursos na tenancy e conceder aos Monitores de Disponibilidade do APM acesso aos recursos do OCI em sua tenancy. Para obter detalhes, consulte Executar Pré-requisitos do Oracle Cloud Infrastructure.
             • Alterações no arquivo de script Java: Faça as seguintes alterações no script:
               • Incluir módulo oci-common

                 const common = require('oci-common');

               • Criar signatário

                 const provider = common.ResourcePrincipalAuthenticationDetailsProvider.builder();const signer = new common.DefaultRequestSigner(provider)

               • Solicitação de Assinatura

                 signer.signHttpRequest(options)

               • Copiar cabeçalhos

                 var headers = {};

                 options.headers.forEach(function(i,v){

                 headers[v] = i;

                 });

        5. Validações de Resposta: Opcionalmente, marque a seguinte caixa de seleção:
           • Código de Resposta: Especifique códigos de status HTTP válidos separados por vírgulas. Por exemplo: 200,401. Ele também aceita o seguinte formato: 2xx, 3xx, 4xx.
        6. Opções: Opcionalmente, marque a caixa de seleção a seguir:
           • Substituir DNS: Selecione esta opção para especificar o endereço IP para o qual o nome de domínio do destino será resolvido, em vez de usar a resolução de DNS padrão.
      • Para o tipo de monitor Network:
        1. URL Base: Especifique o servidor no qual o monitor será executado.
           O endereço IP ou o nome de domínio totalmente qualificado (FQDN) do servidor são valores aceitos. Por exemplo:

           • 192.168.1.1
           • example.com
           Observação
           
           Se estiver usando o protocolo TCP, você precisará também fornecer o número da porta. Por exemplo:

           • 192.168.1.1:8080
           • example.com:80
        2. Protocolo: Especifique o protocolo de rede a ser usado pelo monitor. Pode ser TCP ou ICMP.

           Se o TCP for selecionado, o número da porta será obrigatório para o parâmetro URL Base.

           Se ICMP for selecionado, o número da porta não será obrigatório.

        3. Modo de Investigação: Especifique o modo de investigação para o protocolo de rede TCP. Pode ser: SACK ou SYN. Observe que o Modo de Sondagem só está disponível para o protocolo de rede TCP.
        4. Ativar IPV6: Se marcada, forneça um Destino que possa ser um nome de domínio ou no seguinte formato: [IPv6]:port. Por exemplo: formato: [2001:db8:3333:4444:5555:6666:7777:8888]:90 ou oracle.com:90.
      • Para o tipo de monitor DNS:
        1. Tipo de configuração: Selecione um tipo de configuração para o monitor de DNS:
           • Servidor DNS: Ele executa consultas no servidor de destino. Ele mede o tempo de resolução e a disponibilidade do destino juntamente com as métricas de rede, se ativadas.
           • Rastreamento de DNS: Valida as solicitações de DNS que são delegadas corretamente aos servidores autorizados na zona filho da zona pai.
           • DNSSEC: Valida a autenticidade dos registros de DNS de acordo com as Extensões de Segurança do Sistema de Nomes de Domínio. Ele fornece uma exibição para Árvore Confiável e Cadeia de Dados DNSSec.
        2. Domínio: Especifique o nome do domínio ou o endereço IP a ser usado pelo monitor.
        3. Tipo de Registro: Especifique o tipo de registro DNS a ser usado pelo monitor usando a lista drop-down disponível.
        4. Enviar consultas recursivas: Marque a caixa de seleção se quiser enviar consultas DNS no modo recursivo. Essa opção só estará disponível se o tipo de configuração do monitor do Servidor DNS estiver selecionado.
        5. Protocolo de Transporte: Especifique o protocolo de rede usando a lista drop-down. Pode ser: TCP ou UDP.

           Essa opção estará disponível se os tipos de configuração do monitor Servidor DNS ou Rastreamento de DNS forem selecionados.

        6. Servidor DNS: Especifique o nome do domínio ou o endereço IP do servidor de nomes DNS que será consultado para o nome do domínio no campo do domínio.

           Essa opção só estará disponível se o tipo de configuração do monitor do Servidor DNS estiver selecionado.

        7. Ativar IPV6: Se marcada, forneça um endereço IPv6 ou um nome de domínio para o Servidor DNS. Se o Tipo de Registro for PTR, o Domínio deverá usar o seguinte formato: 0.f.e.d.c.b.a.9.8.7.6.5.4.3.2.1.0.f.e.d.c.b.a.9.8.7.6.5.4.3.2.1.ip6.arpa. Os registros PTR IPv6 são armazenados no domínio .ip6.arpa.
      • Para o tipo de monitor SQL:
        1. Tipo de banco de dados: Selecione o tipo de banco de dados. Oracle e MySQL atualmente suportados.
        2. Nome do Usuário: Especifique o nome do usuário para autenticação do banco de dados. (Necessário).
        3. Tipo de Senha: Especifique o tipo para autenticação do banco de dados. Estes são os dois formatos suportados:
           • OCID do Segredo: OCID do segredo do vault do OCI. Para obter detalhes, consulte Usando Segredos do Vault com Controladores de Recursos.
           • Texto: Senha em formato de texto simples.
        4. Senha: O ocid de senha/segredo da autenticação do banco de dados. (Necessário). Para obter detalhes, consulte Usando Segredos do Vault com Controladores de Recursos.
        5. Atribuição do banco de dados: Especifique a atribuição do banco de dados. (Opcional).

           Para o banco de dados Oracle e o usuário do banco de dados SYS, você deve fornecer a atribuição de banco de dados SYSDBA ou SYSOPER.

           É recomendável criar um monitor com um usuário de banco de dados que tenha privilégios mínimos.

        6. Tipo de conexão do banco de dados: Especifique o tipo de conexão do banco de dados. Os dois tipos a seguir são suportados:
           • JDBC Personalizado: Para esse tipo, o URL de JDBC Personalizado é obrigatório.
           • Cloud Wallet: Essa opção só está disponível ao selecionar o banco de dados Oracle.
             1. Wallet do banco de dados: Especifique o arquivo zip de configuração da wallet da nuvem do banco de dados. (Necessário).
             2. Nome do serviço: Especifique o nome do Serviço de banco de dados a ser usado para estabelecer conexão. (Necessário).
        7. Consulta SQL: Especifique a consulta SQL para extrair dados do banco de dados. Somente a instrução de seleção é permitida. (Necessário).
      • Para o tipo de monitor FTP:
        1. Tipo de protocolo: O protocolo suportado pelo servidor FTP de destino (Obrigatório).

           Os seguintes tipos são suportados: FTP, FTPS e SFTP.

        2. Tipo de solicitação: A solicitação para ser executada pelo FTP. (Necessário).

           Os seguintes tipos são suportados: Download, Upload e Lista.

        3. Caminho: O caminho absoluto para o arquivo ou diretório.

           Obrigatório somente se o tipo de solicitação Download for selecionado.

           Opcional se os tipos de solicitação Carregar e Listar forem selecionados. Se nenhum caminho for especificado para Upload e Lista, o diretório home do usuário FTP que foi especificado na autenticação será usado como caminho padrão.

        4. Tamanho do arquivo: O limite superior do tamanho do arquivo para os tipos de solicitação Download e Upload.

           Obrigatório somente para o tipo de solicitação de upload.

        5. Verificar Conteúdo: Disponível apenas no tipo de solicitação Lista. (Opcional).

           O usuário pode especificar regex para listar arquivos específicos.

        6. Modo Ativo: Suportado somente para protocolos FTP e FTPS. (Opcional).

           Ele controla o modo de transferência de dados e é tratado internamente pela biblioteca cliente FTP. Se ativado, o cliente estabelece o canal de comando e o servidor estabelece o canal de dados.

        7. Autenticação:: (Obrigatório)
           • Nome do Usuário: O nome do usuário para autenticação ftp.
           • Tipo de senha: O tipo da autenticação. (Opcional).

             Os seguintes tipos são suportados:

             1. OCID do Segredo: OCID do segredo do vault do OCI. Para obter detalhes, consulte Usando Segredos do Vault com Controladores de Recursos.
             2. Texto: Senha em formato de texto simples.
           • Senha: A senha ou o ocid secreto para autenticação. Para obter detalhes, consulte Usando Segredos do Vault com Controladores de Recursos.

   Clique em Próximo.

6. Na página Definições de Execução:
   1. Pontos de Vantagem: Selecione os pontos de vantagem nos quais você deseja que o monitor seja executado. Se você tiver configurado um Ponto de Vantagem Dedicado, ele também será listado na lista drop-down e poderá ser selecionado. Para obter informações sobre Pontos de Observação Dedicados, consulte Usar Pontos de Observação Dedicados.
   2. Selecione um dos seguintes botões de opção para determinar a frequência das execuções do monitor:
      • Intervalo: Selecione este botão de opção para determinar o intervalo de tempo entre cada execução do monitor.
      • Executar Uma Vez: Selecione este botão de opção se quiser que o monitor seja executado apenas uma vez. Se o botão de opção Executar Uma Vez for selecionado, a lista suspensa Política de Programação e o campo Intervalo entre Execuções (minutos) serão desativados.
   3. Política de Programação: Selecione uma das seguintes opções para preparar o monitor executado nos pontos de vantagem selecionados:
      • Tudo: Selecione esta opção para executar o monitor simultaneamente em todos os pontos de vantagem selecionados.
      • Revezamento: Selecione esta opção para programar a execução do monitor sequencialmente em cada ponto de vantagem. Essa funcionalidade funciona em conjunto com o valor especificado no campo Intervalo entre Execuções (minutos). Por exemplo, se 10 minutos for especificado no campo Intervalo entre Execuções (minutos) e o monitor for executado em cinco pontos de vantagem, o monitor será executado nos pontos de vantagem sequencialmente com um intervalo de dez minutos entre cada execução. A duração total das execuções do monitor em todos os pontos de vantagem será então de 50 minutos, após os quais a execução do monitor sequencial começará novamente.
      • Revezamento de Correspondência: Selecione esta opção para programar a execução do monitor sequencialmente em lotes de pontos de vantagem. Essa funcionalidade funciona em conjunto com os valores especificados nos campos Intervalo entre Execuções (minutos) e Subintervalo entre Execuções (minutos). Nesse cenário, os monitores são programados para execução em lotes de pontos de vantagem e o intervalo entre cada execução é especificado no campo Subintervalo entre Execuções (minutos). O valor no campo Intervalo entre Execuções (minutos) denota o tempo total gasto para a execução do monitor em todos os lotes.

        O número de pontos de vantagem em cada lote é calculado automaticamente com base no número de pontos de vantagem selecionados e nos valores especificados nos campos Intervalo entre Execuções (minutos) e Subintervalo entre Execuções (minutos). Por exemplo, se houver pontos de vantagem 7, Intervalo entre Execuções (minutos) = 10 minutos e Subintervalo entre Execuções (minutos) = 5 minutos, dois lotes serão criados. O primeiro lote de pontos de vantagem terá quatro pontos de vantagem e o segundo lote terá três.

        
        
        
        
        
   4. Intervalo entre Execuções (minutos): Especifique o número de minutos entre as execuções do monitor. A duração do intervalo padrão é 10 minutos. Para o tipo de monitor REST, você pode especificar um minuto como a duração mínima do intervalo entre as execuções do monitor e, para os outros tipos de monitor, você pode especificar cinco minutos como a duração mínima.

      Observe que se a opção Revezamento de Correspondência for selecionada na lista suspensa Política de Programação, o valor selecionado no campo Intervalo entre Execuções (minutos) denota o tempo total necessário para a execução do monitor em todos os lotes.

   5. Subintervalo entre Execuções (minutos): Especifique o número de minutos entre as execuções do monitor em lotes de pontos de vantagem. Observe que esse campo só será exibido se a opção Revezamento de Correspondência estiver selecionada na lista suspensa Política de Programação.
   6. Timeout (minutos): Especifique o valor do timeout. Isso denota o runtime máximo permitido, e se o runtime do monitor não for concluído nesse tempo, ele será interrompido e marcado como uma falha. Observe que o valor Intervalo entre Execuções deve ser cerca de três vezes maior que o valor Timeout (minutos), no entanto, se a caixa de seleção Ativar Repetição não estiver marcada, o valor Timeout (minutos) poderá ser definido como 50% do valor Intervalo entre Execuções.
   7. Ativar Repetição: Marque esta caixa de seleção para tentar novamente a execução em caso de falha. Observe que esta caixa de seleção é selecionada por padrão.
   8. Ativar Coleta de Rede: Marque esta caixa de seleção para ativar a coleta de dados na rede e monitorar o desempenho da rede. Observe que, para um monitor REST com Script, essa caixa de seleção só será exibida se o URL Base for especificado na página Definição do Monitor:

      Ao marcar a caixa de seleção Ativar Coleta de Rede, as seguintes opções são exibidas:

      • Protocolo: Selecione um protocolo de rede.
      • Modo de Sondagem: Selecione um modo de sondagem para o protocolo de rede TCP. Observe que a opção Modo de Teste só está disponível para o protocolo de rede TCP.
      • Sondagem por Salto: Especifique o número de pacotes de sondagem enviados por salto.

   Clique em Próximo.

7. Na página Configuração de Disponibilidade (Opcional), você pode marcar a caixa de seleção Ativar Configuração de Disponibilidade para configurar os critérios para calcular a disponibilidade do monitor e exibir os detalhes correspondentes no widget Disponibilidade no painel de controle Monitores definido pela Oracle.

   Ao marcar a caixa de seleção Ativar Configuração de Disponibilidade, as seguintes opções são exibidas:

   • Máximo de falhas permitidas por intervalo: Especifique o número máximo de execuções de monitor com falha permitidas em um intervalo. Um intervalo com mais de um número especificado de execuções de monitor com falha será classificado como NÃO DISPONÍVEL.
   • Mínimo de execuções permitidas por intervalo: Especifique o número mínimo de execuções de monitor permitidas em um intervalo. Um intervalo com menos do que o número especificado de execuções de monitor será classificado como DESCONHECIDO e excluído dos cálculos de disponibilidade.

   Clique em Próximo.

   Para obter informações sobre como exibir a disponibilidade do monitor no painel de controle Monitores, consulte Exibir Disponibilidade do Monitor.

8. Na página Tags (Opcional), você pode optar por usar o sistema de metadados do serviço Tagging para organizar e rastrear os monitores e clicar em Próximo.
   Na lista drop-down Namespace de tag, você pode selecionar um namespace prefixado com apm-synthetics e adicionar no máximo cinco Chaves de tag e Valores de tag. Esses pares chave-valor serão adicionados como dimensões e poderão ser usados como qualificadores adicionais para métricas de Monitoramento de Disponibilidade (namespace oracle_apm_synthetics). Isso permite monitorar outros aspectos do monitor, organizar e rastrear monitores usando uma tag específica do APM.

   Observação
   
   O nome da Chave de tag não pode ser igual a uma dimensão existente. Você pode criar qualquer namespace de tag, mas somente namespaces que tenham o prefixo apm-synthetics serão selecionados e publicados no serviço Oracle Cloud Infrastructure Monitoring como uma dimensão.

   Para obter informações sobre:

   • Dimensões e métricas do serviço Availability Monitoring. Consulte Métricas Disponíveis: oracle_apm_synthetics.
   • Tagging, consulte Visão Geral do Serviço Tagging.
9. Na página Resumo, analise o resumo do monitor.
   Se o tipo de monitor for REST, você poderá clicar em Exibir JS para exibir o Javascript com base na entrada fornecida nas etapas anteriores.

   Uma janela é exibida com o Javascript gerado com base na entrada fornecida nas etapas anteriores. No canto superior direito, você tem as seguintes opções disponíveis: Copiar, Fazer Download ou Criar Script.

   Se Criar Script for selecionado, a página Criar Script será exibida para criar um script Javascript. O script criado pode ser usado para criar monitores REST SCRIPTED posteriormente.

   Na página Criar Script, informe o nome do script, siga as etapas e, uma vez concluído, clique em Criar para criar o script Javascript. Para obter detalhes sobre como criar scripts, consulte Criar um Script.

10. Clique em Criar para criar o monitor.