Métricas Personalizadas

Sobre Métricas Personalizadas

Permita que os usuários configurem como as métricas de seus intervalos são coletadas, dependendo de suas necessidades de relatório.
Os usuários podem configurar suas próprias definições de métricas com base nas propriedades dos intervalos, o que permite configurar formas personalizadas de monitorar seus aplicativos.
As métricas personalizadas usam filtros de intervalo para selecionar os intervalos para os quais as métricas devem ser calculadas. Isso permite que os usuários definam diferentes conjuntos de métricas para diferentes tipos de intervalos.
Para relatórios detalhados, as métricas podem ser atribuídas a dimensões que permitem o agrupamento e a filtragem com base nessas dimensões. Por exemplo, usuários de relatórios por tipo de navegador ou artigos vendidos por país.
As Métricas Personalizadas são configuradas no nível de Domínio do APM.

Exemplos de Casos de Uso de Métricas Personalizadas

Exemplo 1: Crie uma métrica para rastrear o número de erros que acontecem durante a etapa de finalização.

Para esse caso de uso, você precisa identificar os intervalos que falharam durante a etapa de check-out. Supondo que o URL da página de check-out termine com checkout.jsp, você pode definir um Span Filter que verifica se o atributo HttpUrl termina com checkout.jsp e também verifica se o atributo Error está definido como verdadeiro.

HttpUrl like '%checkout.jsp' AND Error = 'true'

Como origem de valor, selecione SpanErrorCount. Isso terá o valor 1 se houver um erro na página e 0 caso contrário. Além disso, pode ser interessante saber se os erros só acontecem com navegadores específicos para que você possa adicionar a dimensão BrowserName.

Exemplo 2: Criar uma métrica para rastrear o tempo de resposta da home page

Nesse cenário, queremos rastrear o tempo de resposta de nossa página inicial. Para isso, você pode usar a origem de valor PageResponseTime. Você pode configurar um Span Filter para corresponder à sua home page chamada home.php.

HttpUrl like '%home.php' AND ApmrumType = 'PAGE'

Agora, selecione PageResponseTime para a origem do valor. Além disso, você pode adicionar dimensões à medida que julgar mais adequado. Por exemplo, GeoCountry para obter um detalhamento dos tempos de resposta por país.

Gerenciar Métricas Personalizadas

Para criar uma métrica personalizada para um domínio do APM desejado, faça o seguinte:

Vá para a página Domínios do APM e clique no domínio do APM desejado.

A página Detalhes do domínio é exibida.
Vá para Recursos, localizado na parte inferior esquerda e clique em Métricas personalizadas

O painel Métricas personalizadas é exibido.
No painel Métricas personalizadas, clique em Criar métrica personalizada.

A janela Criar métrica personalizada é exibida.
- Informe o Nome da métrica da nova métrica personalizada.
- Na caixa Filtro de intervalo, escolha um filtro de intervalo (global) predefinido ou digite uma definição de filtro de intervalo local.
- Na lista drop-down Origem do valor da métrica, selecione uma métrica.
- Opcional: Na lista drop-down Dimensões, selecione uma ou várias dimensões. O número máximo de dimensões é 10.
- Opcional: Na lista drop-down Unidade de métrica, selecione uma unidade de métrica.
- Opcional: Clique em Validar métrica personalizada para verificar se algum intervalo ingerido recentemente corresponde ao filtro de intervalo configurado. A ferramenta de validação permite verificar intervalos ingeridos por até 24 horas no passado.
- Clique em Próximo para prosseguir para as opções Escolher armazenamento de métricas.
- Na lista suspensa Compartimento, selecione um compartimento.
- No campo Namespace, informe um namespace.
  O namespace padrão de todas as métricas personalizadas é oracle_apm_custom.
  
  Usar um namespace personalizado: Se preferir, você poderá fornecer um namespace personalizado a ser usado pela métrica personalizada.
  
  Ao usar um namespace não padrão, é necessária uma política para ser criada para o novo namespace.
  - No campo Namespace, edite o valor padrão e informe o namespace preferencial.
  - A mensagem Política necessária para o novo namespace é exibida indicando que a seguinte política é necessária:
    Allow service applicationperformancemonitoring to manage metrics in compartment <compartment_name> where target.metrics.namespace=<custom_namespace_name>
    Por exemplo:
    Allow service applicationperformancemonitoring to manage metrics in compartment ABC where target.metrics.namespace=namespace2
    A política acima permite que o serviço OCI Application Performance Monitoring publique no namespace personalizado.
    As seguintes opções estão disponíveis:
    
    Copiar política: A política é copiada para a área de transferência e precisa ser criada manualmente usando a Console do OCI.
    Use essa opção se você não tiver permissões para criar políticas no OCI. Na maioria dos casos, um usuário administrador precisa criar a política.
    
    Validar política: A política é validada usando uma métrica de teste e verificando as permissões no namespace personalizado.
    
    Aplicar política: A política é criada automaticamente.
    Use esta opção se você tiver permissões para criar políticas no OCI. Por exemplo, se você tiver permissões de administrador.
    Para obter informações sobre como criar políticas, consulte Criando uma política na documentação do Identity Management.
- Opcional: Na lista drop-down Grupo de Recursos, selecione um grupo de recursos.
- Clique em Criar.
  Se o processo de criação falhar ao usar o namespace personalizado, verifique se o serviço Application Performance Monitoring tem acesso para gravar no namespace personalizado.

Use o menu de ação para editar ou excluir uma métrica personalizada.

Se você tiver uma métrica personalizada existente e quiser atualizá-la para começar a usar um namespace personalizado (em vez de usar o namespace padrão oracle_apm_custom), certifique-se de que a política acima seja aplicada ao namespace personalizado.

Documentação do Oracle Cloud Infrastructure

Métricas Personalizadas