Referência da ferramenta New Relic MCP

O servidor MCP da New Relic fornece ferramentas especializadas que permitem que o agente de IA acesse e analise seus dados de observabilidade. Este guia de referência organiza todas as ferramentas disponíveis por categoria.

Como usar as ferramentas MCP

As ferramentas MCP são invocadas por meio de consulta em linguagem natural no seu ambiente de desenvolvimento de IA. Você não precisa memorizar os nomes exatos das ferramentas ou os parâmetros. Basta descrever o que você deseja saber sobre seus dados do New Relic.

Exemplo de consulta:

• "Quais entidades estão na minha conta?"
• "Mostrar alertas recentes para meu aplicativo web"
• "Quais foram os principais erros da última hora?"
• "Execute uma consulta NRQL para analisar o desempenho"

Sua ferramenta de IA selecionará automaticamente as ferramentas MCP apropriadas e formatará os resultados para você.

Ferramentas de filtro com include-tags

Algumas ferramentas aparecem em várias categorias (por exemplo, analyze_deployment_impact é relevante tanto para incident-response quanto para advanced-analysis) porque são tags com várias tags relevantes.

Você pode filtrar dinamicamente as ferramentas que seu agente de IA recebe enviando o cabeçalho include-tags HTTP com suas requests. Isso permite solicitar apenas subconjuntos específicos de ferramentas, o que é útil para reduzir o conjunto de ferramentas e melhorar a eficiência e a precisão do modelo de IA.

As tags disponíveis que você pode usar para filtrar correspondem diretamente aos cabeçalhos de categoria nesta referência: discovery, data-access, alerting, incident-response, performance-analytics, bem como advanced-analysis.

Exemplo de implementação

"servers": {
    "new-relic-mcp-server": {
        "url": "https://mcp.newrelic.com/mcp/",
        "type": "http",
        "headers": {
            "api-key": "NRAK-****",
            "include-tags": "discovery,alerting"
        }
    }
}

Neste exemplo, o agente de IA só receberá ferramentas categorizadas como descoberta (por exemplo, get_entity) e alerta (por exemplo, list_alert_policies), garantindo que o modelo se concentre apenas nas funções mais relevantes para a sua tarefa atual.

entidade e gestão de contas (tag: descoberta)

• convert_time_period_to_epoch_msConverter um período de tempo (por exemplo, "últimos 30 minutos") em milissegundos da época.
• get_dashboardObter detalhes sobre um dashboard específico.
• get_entityRecuperar entidade New Relic por GUID ou pesquisar por padrão de nome.
• list_related_entities: Lista de entidades a 1 salto de distância (relacionadas) de uma determinada entidade GUID.
• list_available_new_relic_accounts: Listar todas as contas IDs disponíveis para o usuário.
• list_dashboardsListar todos os painéis de controle de uma conta New Relic.
• list_entity_typesListe o catálogo completo de tipos de entidades New Relic com suas respectivas definições de domínio/tipo.
• search_entity_with_tag: Pesquise por entidade usando uma chave e um valor tag específicos.

Acesso a dados (tag: acesso-a-dados)

• execute_nrql_queryExecutar uma consulta NRQL no NRDB.
• natural_language_to_nrql_queryExecuta uma consulta convertendo uma solicitação em linguagem natural em uma consulta NRQL, executando-a e retornando os resultados.

Alertas e monitoramento (tag: alertas)

• list_alert_conditions: Lista detalhes da condição do alerta para uma política de alertas específica.
• search_incidentListar todos os incidentes de alerta (tanto eventos abertos quanto fechados) com filtragem flexível.
• list_alert_policiesListar as políticas de alertas para a conta especificada, com opção de filtrar por nome da política.
• list_recent_issuesLista todos os problemas em aberto no New Relic para a conta especificada.
• list_synthetic_monitorsListe todos os monitores Sintético (testes automatizados que verificam a disponibilidade e o desempenho dos seus serviços).

resposta a incidentes (tag: resposta a incidentes)

• analyze_deployment_impact: Analisar o impacto no desempenho de uma implantação em uma entidade específica.
• generate_alert_insights_reportGere um relatório de análise de inteligência de alertas para um problema específico.
• generate_user_impact_reportGere um relatório de análise de impacto para o usuário final referente a um problema específico.
• get_entity_error_groups: Obter grupos de erros para uma entidade específica na Errors Inbox dentro de um período de tempo.
• list_change_events: Liste um histórico de eventos de mudança do New Relic para o aplicativo identificado por sua entidade GUID.

análise de desempenho (tag: análise de desempenho)

• analyze_entity_logsAnalisar o log do aplicativo para identificar padrões de erro, comportamentos anômalos e problemas recorrentes.
• analyze_golden_metrics: Analisar métricas clássicas (indicadores-chave de saúde: taxas de transferência, tempo de resposta, taxas de erros e saturação).
• analyze_kafka_metrics: Analise a métrica Kafka incluindo lag do consumidor, taxas de transferência do produtor, latência da mensagem e saldo da partição.
• analyze_threadsAnalisar dados métricos de threads para uma determinada entidade, incluindo estado da thread, uso da CPU e consumo de memória.
• analyze_transactionsAnalisar as transações de uma entidade específica dentro de um determinado período, identificando as transações lentas e propensas a erros.
• list_garbage_collection_metrics: Listar coleta de lixo e memória métrica para uma determinada conta e entidade.
• list_recent_logs: Listar logs recentes do New Relic para a conta e entidade especificadas GUID.

Análise avançada (tag: análise-avançada)

• analyze_deployment_impact: Analisar o impacto no desempenho de uma implantação em uma entidade específica.
• analyze_entity_logsAnalisar o log do aplicativo para identificar padrões de erro, comportamentos anômalos e problemas recorrentes.
• generate_alert_insights_reportGere um relatório de análise de inteligência de alertas para um problema específico.
• generate_user_impact_reportGere um relatório de análise de impacto para o usuário final referente a um problema específico.
• natural_language_to_nrql_queryConverter uma solicitação em linguagem natural em uma consulta NRQL, executá-la e retornar os resultados.