Todos os produtos
Search

Este produto

    Application Real-Time Monitoring Service:Custom configuration for Golang applications

    Central de documentação

    Application Real-Time Monitoring Service:Custom configuration for Golang applications

    Última atualização: Jun 27, 2026

    A aba Custom Configuration permite ajustar o comportamento do probe da sua aplicação Golang, incluindo políticas de amostragem, captura HTTP, propagação de rastreamento, limiares de chamadas lentas e opções de profiling.

    Nota

    Para configurar esses parâmetros programaticamente, use a API SaveTraceAppConfig.

    Pré-requisitos

    Antes de começar, verifique se você tem:

    Acessar a página de configuração personalizada

    1. Faça login no console do ARMS. No painel de navegação à esquerda, escolha Application Monitoring > Application List.

    2. Na página Application List, selecione uma região no topo e clique em nome da sua aplicação.

      Nota

      Os ícones na coluna Language indicam o tipo de aplicação:

      Java icon: Aplicação Java integrada ao Application Monitoring.

      Go icon: Aplicação Golang integrada ao Application Monitoring.

      Python icon: Aplicação Python integrada ao Application Monitoring.

      - : Aplicação integrada ao Managed Service for OpenTelemetry.

    3. Na barra de navegação superior, escolha Application Configuration > Custom Configuration.

    4. Configure os parâmetros descritos nas seções a seguir e clique em Save.

    Configurações de amostragem

    Aplicações Golang suportam apenas amostragem de taxa fixa. Também é possível configurar amostragem completa por nome de interface, prefixo ou sufixo.

    Sampling settings

    Configurações de ativação do probe

    Ative ou desative o Application Monitoring e alterne plugins individuais.

    Importante

    A ativação ou desativação do Application Monitoring tem efeito imediato, sem necessidade de reinicialização. Se você pausar o Application Monitoring, o ARMS interromperá o monitoramento da sua aplicação. Proceda com cautela.

    A alteração de plugins individuais exige a reinicialização da aplicação para entrar em vigor.

    Configurações de ativação do Runtime

    Ative ou desative o monitoramento de Runtime. Para mais detalhes, consulte Monitoramento de Runtime.

    Importante

    As alterações entram em vigor dinamicamente, sem necessidade de reinicialização. Se você desativar o monitoramento de Runtime, o ARMS deixará de coletar métricas de Runtime. Proceda com cautela.

    Runtime toggle settings

    Associação de logs da aplicação

    Associe fontes de log à sua aplicação para injetar SpanId e TraceId nos logs. Para mais detalhes, consulte Associar logs de negócios de aplicações Golang ao TraceId.

    Nota

    É possível personalizar as chaves usadas para trace_id e span_id nos logs.

    Configurações de convergência de URL

    Agrupe URLs semelhantes em uma única entrada. Por exemplo, todas as URLs que começam com /service/demo/ aparecem como uma entrada combinada.

    Configuração

    Descrição

    URL convergence

    Ativa ou desativa o agrupamento de URLs.

    Convergence threshold

    Quantidade mínima de URLs correspondentes antes que a convergência ocorra. Por exemplo, se o limiar for 100, o ARMS agrupa as URLs somente quando pelo menos 100 URLs corresponderem à expressão regular especificada.

    Convergence rules

    Padrões de expressão regular para correspondência de URLs.

    Para mais detalhes, consulte Mecanismo de convergência do ARMS.

    URL convergence settings

    Configurações de profiling contínuo

    Ative ou desative a opção global de profiling, hotspots de CPU, hotspots de memória e hotspots de código. Para mais detalhes, consulte Profiling contínuo para aplicações Golang.

    Configuração de chamadas de API

    Configure a detecção de chamadas lentas, o tratamento de códigos de status HTTP, a captura de requisição/resposta e a filtragem de APIs.

    API call configuration

    Limiar de chamada lenta

    Configuração

    Valor

    Padrão

    500

    Comportamento

    Se o tempo de resposta de uma interface exceder este valor, o ARMS a marca como uma chamada lenta.

    Lista de permissões de códigos de status HTTP

    Por padrão, códigos de status HTTP maiores que 400 são classificados como erros. Adicione códigos de status específicos à lista de permissões para evitar essa classificação.

    Esta configuração aplica-se apenas a frameworks HTTP suportados pelo Application Monitoring. Para verificar os frameworks suportados, consulte Frameworks HTTP suportados.

    Configuração

    Valor

    Padrão

    Vazio

    Formato

    Insira códigos de status individuais separados por vírgulas (,). Não há suporte para correspondência aproximada.

    Exemplo

    403,502

    Impacto nas métricas: Contagens de erros para servidores e clientes HTTP (arms_http_requests_error_count, arms_http_client_requests_error_count e arms_app_requests_error_count) e status do Span.

    Impacto nos recursos: Contagens de erros nas abas Application Overview, Provided Services e Dependent Services. Status do Span e alertas de contagem de erros na página Trace Analysis.

    Filtragem de chamadas de API inválidas

    Oculte chamadas de API específicas da aba Provided Services. O probe deixa de reportar dados de telemetria para as APIs filtradas, impedindo que elas apareçam na visualização de chamadas de API.

    Configuração

    Valor

    Padrão

    /**/*.jpg,/**/*.png,/**/*.js,/**/*.jpeg,/**/*.pdf,/**/*.xlsx,/**/*.txt,/**/*.docs,/**/*.gif,/**/*.csv

    Formato

    Use uma string ou expressão AntPath para corresponder ao nome completo da API. Separe múltiplas regras com vírgulas (,).

    Exemplo

    /api/test/*,/api/playground/create
    Nota

    As expressões AntPath padrão estão incluídas para manter compatibilidade com dados históricos. Não as exclua. Adicione novas regras após as existentes.

    Impacto nas métricas: Todas as métricas e Spans das APIs especificadas são ignorados.

    Impacto nos recursos: Todas as métricas nas abas Application Overview, Provided Services e Dependent Services. Contagem de Spans, contagem de chamadas, contagem de erros e alertas de chamadas lentas na página Trace Analysis.

    Captura de requisição e resposta HTTP

    Configuração

    Descrição

    Enable HTTP request body logging

    Captura o corpo da requisição e adiciona o campo http.request.body aos Spans do cliente HTTP.

    Enable HTTP request header logging

    Captura os cabeçalhos da requisição e adiciona o campo http.request.header aos Spans do cliente HTTP.

    HTTP request body length

    Comprimento máximo do corpo da requisição HTTP capturado. O comprimento padrão é de 1024 caracteres.

    Include TraceId in HTTP response headers

    Adiciona o TraceId aos cabeçalhos de resposta com a chave Eagleeye-TraceId.

    Enable HTTP response body logging

    Captura o corpo da resposta e adiciona o campo http.response.body aos Spans do servidor HTTP.

    Enable HTTP response header logging

    Captura os cabeçalhos da resposta e adiciona o campo http.response.header aos Spans do servidor HTTP.

    HTTP response body length

    Comprimento máximo do corpo da resposta HTTP capturado. O comprimento padrão é de 1024 caracteres.

    HTTP request header keys to include in Spans

    Especifique chaves de cabeçalho (separadas por vírgula) para adicionar como http.request.header.key nos Spans do cliente HTTP.

    HTTP response header keys to include in Spans

    Especifique chaves de cabeçalho (separadas por vírgula) para adicionar como http.response.header.key nos Spans do servidor HTTP.

    Configuração avançada de filtragem de exceções

    Configuração

    Descrição

    Collection plugin abnormality

    Indica se o plugin de coleta está anormal.

    Exception filter whitelist

    Oculta exceções específicas da aba Exception Analysis. Insira os nomes das exceções a serem excluídas das estatísticas.

    Configuração de chamadas de banco de dados

    Configure a detecção de SQL lento e as opções de exibição de instruções SQL.

    Database call configuration

    Configuração

    Descrição

    Reinicialização necessária

    Slow SQL threshold

    Se o tempo de resposta de uma consulta SQL exceder este valor, o ARMS a marca como uma chamada SQL lenta.

    Não

    Maximum SQL length

    Comprimento máximo das instruções SQL capturadas.

    Não

    Display bound variable values in SQL

    Captura valores de variáveis vinculadas a parâmetros PreparedStatement.

    Não

    Display constant values in SQL

    Apenas trunca instruções SQL, sem processamento adicional.

    Não

    Configurações de protocolo de propagação de rastreamento

    Selecione o protocolo de propagação de rastreamento adequado às suas necessidades. W3C é o protocolo padrão. Você também pode escolher Zipkin, Jaeger ou EagleEye.

    Configuração de coleta do probe

    Defina o número máximo de rastreamentos coletados por segundo e o nível de log do probe.

    Configuração

    Descrição

    Maximum traces per second

    Número máximo de rastreamentos que o probe coleta a cada segundo.

    Probe log level

    Nível de log do probe.

    Custom metric collection

    Controla se o probe coleta métricas definidas no seu código usando o SDK do OpenTelemetry.

    Enable Span reporting

    Ativado por padrão. Se desativado, nenhum Span será reportado.

    Span Reporting Name

    Nome do Span a ser reportado após o encerramento.

    Custom metric collection configuration

    Configure o nome do escopo da métrica. Se não configurado, todas as métricas personalizadas serão coletadas por padrão.

    Filtragem de coleta de métricas padrão

    Filtre os tipos de métricas que o probe reporta. Selecione um ou mais dos seguintes tipos:

    Tipo

    Métricas abrangidas

    custom_entry

    Métricas personalizadas para monitoramento de métodos

    http

    Métricas de servidor HTTP

    http_client

    Métricas de cliente HTTP

    rpc

    Métricas de chamadas de servidor RPC

    rpc_client

    Métricas de chamadas de cliente RPC

    sql

    Métricas de acesso a banco de dados

    nosql

    Métricas de acesso a serviços NoSQL

    cache

    Métricas de acesso a serviços de cache

    producer

    Métricas de publicação de mensagens

    consumer

    Métricas de consumo de mensagens

    schedule

    Métricas de serviço de agendamento

    Configurações avançadas

    Configure cálculos de percentil, amostragem de chamadas lentas e erros, e o comprimento máximo do stack trace para exceções.

    Advanced settings

    Copiar configurações para outras aplicações

    Aplique a mesma configuração a outras aplicações.

    Copiar uma única configuração

    1. Na seção da configuração desejada, clique em Save and bulk copy to other applications.

    2. Se a caixa de diálogo Current settings not saved aparecer, clique em OK para salvar a configuração da aplicação atual e clique novamente em Save and bulk copy to other applications.

    3. Selecione as aplicações de destino e clique em OK.

    Copiar todas as configurações

    1. Na parte inferior da página, clique em Save and bulk copy to other applications.

    2. Se a caixa de diálogo Current settings not saved aparecer, clique em OK para salvar as configurações da aplicação atual e clique novamente em Save and bulk copy to other applications.

    3. Selecione as aplicações de destino e clique em OK.

    Salvar como padrões globais

    Salve a configuração atual como padrão global. Todas as novas aplicações usarão essas configurações automaticamente.

    1. Na parte inferior da página, clique em Save current app settings as global default configuration.

    2. Se a caixa de diálogo Current settings not saved aparecer, clique em OK para salvar as configurações da aplicação atual e clique novamente em Save current app settings as global default configuration.

    3. Na caixa de diálogo de confirmação, clique em Confirm.