Fichier de configuration du Serveur RMT
Cette rubrique décrit les options de configuration que vous pouvez utiliser à l’aide du fichier de configuration. Si vous utilisez l’interface Web à cette fin, consultez Configuration du serveur Resource Monitoring Tool.
Nous veillons à mettre en œuvre l’une des valeurs fondamentales de notre entreprise, à savoir l’égalité, et à cette fin, nous avons modifié la terminologie afin d’être le plus inclusifs possible. Étant donné que la modification des termes à certains endroits peut entraîner un changement radical, nous conservons la terminologie existante. Il se peut donc que vous continuiez à voir les termes dans les commandes et options de l’interface en ligne de commande, dans les dossiers d’installation, dans les fichiers de configuration et dans d’autres instances. Pour plus d’informations, consultez À propos de l’Aide de Tableau(Le lien s’ouvre dans une nouvelle fenêtre).
Le fichier de configuration se trouve à l’adresse %PROGRAMFILES%\Tableau\Tableau Resource Monitoring Tool\master\config\config.json
. Ce chemin peut varier en fonction de votre installation.
Remarque : les valeurs de configuration sont enregistrées dans le fichier de configuration. Vous pouvez apporter des modifications directement à ce fichier, mais il est conseillé de tirer parti des options de configuration dans l’interface utilisateur et via l’utilitaire de ligne de commande rmtadmin
. L’application des modifications apportées au fichier config nécessite un redémarrage.
Vous devez redémarrer le Serveur RMT après avoir apporté des modifications au fichier de configuration.
Conservation des données
Par défaut, Resource Monitoring Tool stocke deux semaines de données détaillées et dix années de données de rapports agrégées.
Ces paramètres sont configurables. Voici un exemple de snippet définissant les paramètres de conservation des données :
Configuration SMTP
Exemple de snippet config.json
définissant les informations SMTP :
{
"smtp": {
"server": "localhost",
"port": 25,
"username": "my-username",
"password": "my-password",
"requireSSL": true
}
}
Liste complète des valeurs de configuration disponibles dans la section de configuration smtp
:
Clé | Type de données | Obligatoire? | Description |
---|---|---|---|
server | Chaîne | Facultatif | Le serveur SMTP à utiliser. Valeur par défaut : localhost |
port | Nombre | Facultatif | Le numéro de port du serveur SMTP. Valeur par défaut : 25 |
username | Chaîne | Facultatif | Le nom d’utilisateur à utiliser si l’authentification est requise par le serveur. |
password | Chaîne | Facultatif | Le mot de passe à utiliser si l’authentification est requise par le serveur. |
requireSSL | Booléen | Facultatif | true si votre serveur SMTP requiert SSL, sinon false . Valeur par défaut : false |
Configuration des notifications
Exemple de snippet config.json
définissant les informations de notification :
{
"notifications": {
"email": {
"from": "sender@domain.com",
"to": "recipient1@domain.com,recipient2@domain.com"
}
}
}
Les informations de notification globales (comme indiqué ci-dessus) peuvent être remplacées par environnement dans la section environments
:
{
"environments": {
"Environment1": {
"notifications": {
"email": {
"from": "sender@domain.com",
"to": "recipient1@domain.com,recipient2@domain.com"
}
}
}
}
}
Liste complète des valeurs de configuration disponibles dans la section de configuration notifications.email
:
Clé | Type de données | Obligatoire? | Description |
---|---|---|---|
from | Chaîne | Obligatoire | Adresse de courriel de l’utilisateur. |
to | Chaîne | Obligatoire | Adresse(s) de courriel du destinataire. Les adresses multiples doivent être séparées par des virgules ou des points-virgules. |
minimumIncidentSeverity | Chaîne | Facultatif | La gravité minimale de l’incident déclenchant l’envoi de courriels. Valeur par défaut : critical . Voir aussi Tableau Resource Monitoring Tool - Incidents. |
Configuration des histogrammes
Les limites utilisées pour générer des histogrammes dans l’interface Web sont configurables, en utilisant un tableau de valeurs représentant chaque limite.
Liste complète des histogrammes configurables dans la section monitoring.histograms
:
Clé | Type de données | Obligatoire? | Description |
---|---|---|---|
viewLoadDuration | Tableau de nombres | Facultatif | Limites de l’histogramme pour les chargements de vue. Les valeurs sont en millisecondes. Valeur par défaut : [1000, 3000, 6000, 10000] |
externalDataRequestDuration | Tableau de nombres | Facultatif | Limites de l’histogramme pour les demandes de données externes. Les valeurs sont en millisecondes. Valeur par défaut : [1000, 3000, 6000, 10000] |
backgroundTaskDuration | Tableau de nombres | Facultatif | Limites de l’histogramme pour les tâches en arrière-plan. Les valeurs sont en millisecondes. Valeur par défaut : [60000, 300000, 600000, 1800000] |
Par exemple, pour utiliser les compartiments d’histogrammes suivants pour tout à un niveau global :
- ≤ 1 seconde
- > 1 seconde et ≤ 10 secondes
- > 10 secondes et ≤ 30 secondes
- > 30 secondes
La configuration se présenterait ainsi :
{
"monitoring": {
"histograms": {
"viewLoadDuration": [1000, 10000, 30000],
"externalDataRequestDuration": [1000, 10000, 30000],
"backgroundTaskDuration": [1000, 10000, 30000]
}
}
}
Les limites des histogrammes peuvent également être définies par environnement. À titre d’exemple, pour un environnement dont l’identificateur est « staging-environnement », utilisez les compartiments d’histogramme de vue suivants :
- ≤ 2,5 secondes
- > 2,5 secondes et ≤ 5 secondes
- > 5 secondes et ≤ 30 secondes
- > 30 secondes et ≤ 1 minute
- > 1 minute et ≤ 10 minutes
- > 10 minutes
La configuration se présenterait ainsi :
{
"environments": {
"staging-environment": {
"monitoring": {
"histograms": {
"viewLoadDuration": [2500, 5000, 30000, 60000, 600000]
}
}
}
}
}
Le « staging-environnement » reviendrait à la configuration globale de l’histogramme pour les tâches en arrière-plan.
Version TLS minimale
Par défaut, RMT utilisera une version sécurisée de TLS pour chiffrer le trafic. La version minimale par défaut est 1.2, mais si vous avez des exigences de sécurité spécifiques qui imposent de désactiver les anciennes versions de TLS, vous pouvez modifier la section server.minimumTlsVersion
du fichier de configuration pour appliquer une version TLS minimale, comme le montre l’exemple d’extrait ci-dessous où la version minimale est définie sur 1.3. Les valeurs valides pour minimumTlsVersion
sont définies dans les SslProtocols de .Net Core(Le lien s’ouvre dans une nouvelle fenêtre).
Configuration des incidents
Consultez Incidents pour plus d’informations sur les options d’incident disponibles et sur la façon de les configurer.
Fichiers journaux du Serveur RMT
Agent
Le fichier de configuration du service d’agent se trouve à l’adresse %PROGRAMFILES%\Tableau\Tableau Resource Monitoring Tool\agent\config\config.json
. Ce chemin peut varier en fonction de votre installation.
Vous devez redémarrer le service d’agent après avoir apporté des modifications au fichier de configuration.
Détection de Tableau Server
Dans presque toutes les situations, les agents détectent automatiquement l’installation de Tableau Server et aucune configuration n’est nécessaire au-delà du processus de configuration des agents. Si vous le souhaitez, vous pouvez cependant configurer manuellement les informations de Tableau Server via le fichier config.json
.
Exemple de snippet config.json
définissant les informations de Tableau Server nécessaires à l’exécution de l’agent :
{
"agent": {
"tableauServer": {
"override": true,
"productVersion": 2021.4,
"applicationDirectory": "C:\\Tableau\\Tableau Server\\2021.4"
}
}
}
Les barres obliques arrières doivent être échappées comme indiqué ci-dessus pour le format JSON.
Liste complète des valeurs de configuration disponibles dans la section de configuration agent.tableauServer
:
Clé | Type de données | Obligatoire? | Description |
---|---|---|---|
applicationDirectory | Chaîne | Obligatoire | Répertoire racine de l’application Tableau Server. |
dataDirectory | Chaîne | Facultatif | Répertoire pour obtenir les fichiers de données de Tableau Server. |
override | Booléen | Facultatif | true pour que les valeurs de configuration prévalent sur toutes les valeurs détectées automatiquement. false pour que les valeurs de configuration servent de secours par rapport aux valeurs détectées automatiquement. |
productVersion | Nombre | Obligatoire | Numéro de version de Tableau Server. |
Journaux de l’agent
Voir Fichiers journaux de Tableau Resource Monitoring Tool.
Commun
Des valeurs de configuration communes sont disponibles à la fois dans les applications de Serveur RMT et d’Agent. Reportez-vous aux sections spécifiques à l’application pour obtenir des conseils sur la localisation du fichier de configuration.
Vous devez redémarrer le service de l’application si vous apportez des modifications au fichier de configuration.
Messagerie chiffrée
Pour activer la messagerie chiffrée, le serveur RabbitMQ doit d’abord être configuré pour autoriser TLS. Consultez le guide de l’administrateur de la Collecte de données chiffrées pour plus de détails.
Lors de la configuration du Serveur RMT ou des Agents pour la messagerie chiffrée :
- Vous devez configurer à la fois l’indicateur
enabled
etcertificateHostName
pour activer le chiffrement. - La variable
certificateHostName
DOIT correspondre au nom canonique (CN=) sur le certificat du serveur sinon la connexion échouera. - Le paramètre
port
dans la sectionmq
devra probablement être modifié sur le port TLS sur lequel vous avez configuré RabbitMQ.
Liste complète des valeurs de configuration disponibles dans la section de configuration mq.tls
:
Clé | Type de données | Obligatoire? | Description |
---|---|---|---|
enabled | Booléen | Facultatif | true active le chiffrement TLS pour les connexions de messagerie. false utilise des connexions non chiffrées pour la messagerie. Valeur par défaut : false |
certificateHostName | Chaîne | Facultatif | certificateHostName DOIT correspondre au nom canonique (CN=) du certificat du serveur sinon la connexion échouera. Valeur par défaut : "" |
Qui peut le faire?
Administrateur Resource Monitoring Tool ou utilisateur Resource Monitoring Tool ayant un rôle Gestion du serveur/de l’environnement.