Référence de l'outil New Relic MCP

Le serveur MCP de New Relic fournit des outils spécialisés permettant aux agents d'IA d'accéder à vos données d'observabilité et de les analyser. Ce guide de référence répertorie tous les outils disponibles par catégorie.

Comment utiliser les outils MCP

Les outils MCP sont invoqués via une requête en langage naturel dans votre environnement de développement d'IA. Vous n'avez pas besoin de mémoriser les noms exacts des outils ni leurs paramètres. Décrivez simplement ce que vous souhaitez savoir sur vos données New Relic.

Exemple de requête :

« Quelles entités sont présentes sur mon compte ? »
« Afficher les alertes récentes concernant mon application web »
«Quelles sont les principales erreurs de la dernière heure ?»
"Exécutez une requête NRQL pour analyser les performances"

Votre outil d'IA sélectionnera automatiquement les outils MCP appropriés et formatera les résultats pour vous.

Outils de filtrage avec `include-tags`

Certains outils apparaissent dans plusieurs catégories (par exemple, analyze_deployment_impact est pertinent à la fois pour incident-response et advanced-analysis) car ils sont étiquetés avec plusieurs étiquettes pertinentes.

Vous pouvez filtrer dynamiquement les outils que votre agent IA reçoit en envoyant l'en-tête include-tags HTTP avec vos requests. Cela vous permet de ne demander que des sous-ensembles spécifiques d'outils, ce qui est utile pour réduire le corpus d'outils et améliorer l'efficacité et la précision du modèle d'IA.

Les balises disponibles que vous pouvez utiliser pour le filtrage correspondent directement aux en-têtes de catégorie de cette référence : discovery, data-access, alerting, incident-response, performance-analytics, ainsi que advanced-analysis.

Exemple d'implémentation

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

Dans cet exemple, l'agent d'IA ne se verra présenter que des outils classés dans la catégorie découverte (par exemple, get_entity) et alerte (par exemple, list_alert_policies), garantissant ainsi que le modèle se concentre uniquement sur les fonctions les plus pertinentes pour sa tâche actuelle.

Important

Sécurité et accès : Lorsque votre agent d'IA invoque l'un des outils listés ci-dessous (par exemple, fetch_entity, analyze_deployment_impact, execute_nrql_query), l'action qu'il effectue est strictement régie par les autorisations accordées à la clé API utilisateur New Relic ou au profil OAuth qui a été configuré lors de la configuration. L'outil ne peut accéder qu'aux données, entités et comptes auxquels votre compte utilisateur correspondant a obtenu l'accès via le contrôle d'accès basé sur les rôles (RBAC) de New Relic. Si votre clé ne dispose pas des autorisations nécessaires pour une action spécifique (par exemple, la consultation des alertes ou l'exécution de requêtes NRQL), l'appel de l'outil échouera avec une erreur d'autorisation.

Gestion des entités et des comptes (tag: découverte)

convert_time_period_to_epoch_ms: Convertir une période de temps (par exemple, « les 30 dernières minutes ») en millisecondes epoch.
get_dashboard: Récupérer les détails d'un dashboard spécifique.
get_entity: Récupérer une entité New Relic par GUID ou rechercher par modèle de nom.
list_related_entities: Répertorie l'entité à 1 saut (liée) d'une entité donnée GUID.
list_available_new_relic_accounts: Liste de tous les comptes IDs disponibles pour l'utilisateur.
list_dashboards: Lister tous les tableaux de bord d'un compte New Relic.
list_entity_types: Liste du catalogue complet des types d'entités New Relic avec définitions de domaine/type.
search_entity_with_tag: Rechercher une entité à l'aide d'une clé et d'une valeur tag spécifiques.

Accès aux données (tag : accès aux données)

execute_nrql_query: Exécuter une requête NRQL sur NRDB.
natural_language_to_nrql_query: Exécuter une requête en convertissant une demande en langage naturel en une requête NRQL, en l'exécutant et en renvoyant les résultats.

Alertes et monitoring (tag: alertes)

list_alert_conditions: Répertorie les détails de la condition d'alerte pour une règle d'alerte spécifique.
search_incident: Répertoriez tous incident d'alerte événement (événements d'ouverture et de fermeture) avec un filtrage flexible.
list_alert_policies: Liste des règles d'alerte pour le compte spécifié, avec possibilité de filtrage par nom de politique.
list_recent_issues: Liste tous les problèmes ouverts dans New Relic pour le compte spécifié.
list_synthetic_monitors: Lister tous les moniteurs Synthétique (tests automatisés qui vérifient la disponibilité et les performances de vos services).

réponse aux incidents (tag: réponse aux incidents)

analyze_deployment_impactAnalyser l'impact d'un déploiement sur les performances d'une entité spécifique.
generate_alert_insights_reportGénérer un rapport d'analyse des renseignements sur une alerte concernant un problème spécifique.
generate_user_impact_reportGénérer un rapport d'analyse d'impact pour l'utilisateur final concernant un problème spécifique.
get_entity_error_groups: Récupérer les groupes d'erreurs pour une entité spécifique à partir de la Errors Inbox dans un intervalle de temps donné.
list_change_events: Lister un historique des événements de changement de New Relic pour l'application identifiée par son entité GUID.

Analyse des performances (tag : analyse-des-performances)

analyze_entity_logsAnalyser les logs d'application pour identifier les schémas d'erreur, les comportements anormaux et les problèmes récurrents.
analyze_golden_metrics: Analyser les métriques dorées (indicateurs clés de santé : débit, temps de réponse, taux d'erreur et saturation).
analyze_kafka_metricsAnalyser les métriques Kafka, notamment le délai du consommateur, le débit du producteur, la latence des messages et l'équilibre des partitions.
analyze_threads: Analysez les données métriques du thread pour une entité donnée, y compris l'état du thread, l'utilisation du processeur et la consommation de la mémoire.
analyze_transactionsAnalyser les transactions d'une entité spécifique sur une période donnée, en identifiant les transactions lentes et sujettes aux erreurs.
list_garbage_collection_metrics: Afficher les métriques de récupération de mémoire et de mémoire pour un compte et une entité donnés.
list_recent_logs: Liste des logs récents de New Relic pour le compte et l'entité spécifiés GUID.

Analyse avancée (tag : analyse-avancée)

analyze_deployment_impactAnalyser l'impact d'un déploiement sur les performances d'une entité spécifique.
analyze_entity_logsAnalyser les logs d'application pour identifier les schémas d'erreur, les comportements anormaux et les problèmes récurrents.
generate_alert_insights_reportGénérer un rapport d'analyse des renseignements sur une alerte concernant un problème spécifique.
generate_user_impact_reportGénérer un rapport d'analyse d'impact pour l'utilisateur final concernant un problème spécifique.
natural_language_to_nrql_queryConvertir une requête en langage naturel en une requête NRQL, l'exécuter et renvoyer les résultats.