Le cloud d'intégration Mendix collecte et envoie l'inventaire et les métriques de votre environnement cloud Mendix à New Relic afin que vous puissiez monitorer son état et ses performances.
Lisez la suite pour installer l’intégration et voir quelles données nous collectons.
Installation
Pour utiliser New Relic, vous avez besoin d'une clé API New Relic. Pour trouver une clé existante ou en demander une nouvelle pour votre application, suivez ces étapes :
- connectez-vous à votre compte New Relic.
- Ouvrez les options du menu utilisateur en cliquant sur votre nom dans le coin inférieur gauche. Cliquez ensuite sur la clé API.
- Copiez une clé API existante ou créez-en une nouvelle. À cette fin, New Relic recommande le type
License
.
Important
Le logging New Relic et les métriques d'application sont pris en charge dans Mendix 9.7 et versions ultérieures.
Connecter votre environnement à New Relic
Pour envoyer vos informations d'exécution à New Relic, vous devez fournir la clé API New Relic à votre environnement.
Accédez à la page Environment de votre application dans le Developer Portal.
Cliquez sur Details sur l'environnement que vous souhaitez monitorer avec New Relic.
Passez à l’onglet Details .
Ajoutez les variables d’environnement personnalisées suivantes :
Variable
Description
NEW_RELIC_LICENSE_KEY
Clé de licence New Relic.
NEW_RELIC_LOGS_URI
URI pour l'API du log de New Relic. Pour plus d'informations, consultez Régions New Relic. Pour connaître les valeurs valides, consultez Envoyer vos données de logging avec notre API de log Exemple :
https://log-api.eu.newrelic.com/log/v1
NEW_RELIC_METRICS_URI
URI pour l'API Métriques de New Relic. Pour plus d'informations, consultez Régions New Relic. Pour les valeurs valides, voir Rapport métriques via l'API métrique. Exemple :
https://metric-api.eu.newrelic.com/metric/v1
.NEW_RELIC_APP_NAME
(facultatif)Nom de l'application Mendix affiché sur la page APM et services de New Relic. Par défaut : nom d’hôte du domaine.
LOGS_REDACTION
(facultatif)Les adresses e-mail sont automatiquement expurgées avant que les entrées log ne soient envoyées à New Relic. Pour désactiver cette rédaction, définissez
LOGS_REDACTION
surfalse
. Par défaut :true
.Revenez à la page Environments de votre application et Deploy ou Transport votre application dans l'environnement sélectionné.
Important
Pour commencer à envoyer des données à New Relic, vous devez redéployer votre application, puis la redémarrer. Le simple redémarrage de l'application n'est pas suffisant car des dépendances supplémentaires doivent être incluses.
métriques de balises pour New Relic
Pour vous aider à analyser les métriques de votre application comme décrit dans la section Métriques de l'application du monitoring de vos applications Mendix avec un outil APM, Mendix ajoute une balise aux métriques des microflux et des activités lors de l'utilisation de New Relic.
En plus du log d'exécution de l'application, la métadonnées au format JSON suivante est automatiquement envoyée à New Relic :
environment_id
: Identifiant unique de l'environnementinstance_index
: Numéro de l'instance de l'applicationhostname
: Nom de l'hôte de l'applicationapplication_name
: Nom d'application par défaut, récupéré à partir du nom de domainemodel_version
:Version modèle de l'environnement d'exécution Mendixruntime_version
: Version de l'environnement d'exécution Mendix
Vous pouvez filtrer les données par ces champs.
Étiquette personnalisée
Si vous utilisez New Relic pour monitorer plusieurs applications et environnements, vous ne pourrez pas déterminer à quelle application ou à quel environnement ces mesures s'appliquent. Pour identifier les métriques de votre application et de votre environnement dans New Relic, vous devez ajouter une balise pour le nom de l'application et l'environnement.
Mendix recommande d'utiliser la balise suivante :
app:{app_name}
(par exemple,app:customermanagement
) : cela vous permet d'identifier toutes les métriques envoyées depuis votre applicationenv:{environment_name}
(par exemple, `env:accp``) : cela vous permet d'identifier les métriques envoyées depuis un environnement particulier afin que vous puissiez séparer les métriques de production des métriques de test