Aller au contenu principal

Dynamics AX CMA

Le connecteur permet de superviser :

  • Windows Server OS Ă  partir de la version 2003 SP2
  • Windows (postes de travail) Ă  partir de la version XP.

Contenu du pack​

Modèles​

Le connecteur de supervision Dynamics AX CMA apporte un modèle d'hôte :

  • App-Dynamics-AX-CMA-custom

Le connecteur apporte les modèles de service suivants (classés selon le modèle d'hôte auquel ils sont rattachés) :

AliasModèle de serviceDescription
RIS-Import-InputApp-Dynamics-AX-RIS-Import-Input-CMA-customContrôle permettant de vérifier la présence de fichiers à importer
RIS-Import-ProcessingErrorsApp-Dynamics-AX-RIS-Import-ProcessingErrors-CMA-customContrôle permettant de vérifier les fichiers importés en échec
Service-RISApp-Dynamics-AX-Service-RIS-CMA-customContrôle permettant de vérifier l'état du service RecurringIntegrationsScheduler

Les services listés ci-dessus sont créés automatiquement lorsque le modèle d'hôte App-Dynamics-AX-CMA-custom est utilisé.

Métriques & statuts collectés​

Voici le tableau des services pour ce connecteur, détaillant les métriques rattachées à chaque service.

NomUnité
countcount

Prérequis​

Flux réseau​

Un flux TCP doit être ouvert depuis l'hôte supervisé vers le collecteur.

SourceDestinationProtocolePortObjet
Hôte superviséCollecteurTCP4317Obtention de la configuration et envoi des données au format OpenTelemetry.

Installation de Centreon Monitoring Agent​

La procédure d'installation et de configuration de Centreon Monitoring Agent pour Windows est détaillée dans la documentation dédiée à ce sujet. Cela comprend l'installation de l'agent et des plug-ins qui exécuteront les contrôles non natifs. (Ce lien vous redirige vers la dernière version de la documentation OnPrem. Utilisez le sélecteur de version dans le coin supérieur droit pour passer à une autre version si nécessaire.)

Installer le connecteur de supervision​

Pack​

La procédure d'installation des connecteurs de supervision diffère légèrement suivant que votre licence est offline ou online.

  1. Si la plateforme est configurée avec une licence online, l'installation d'un paquet n'est pas requise pour voir apparaître le connecteur dans le menu Configuration > Connecteurs > Connecteurs de supervision. Au contraire, si la plateforme utilise une licence offline, installez le paquet sur le serveur central via la commande correspondant au gestionnaire de paquets associé à sa distribution :
dnf install centreon-pack-applications-dynamics-cma
  1. Quel que soit le type de la licence (online ou offline), installez le connecteur Dynamics AX CMA depuis l'interface web et le menu Configuration > Connecteurs > Connecteurs de supervision.

Plugin​

Ce connecteur de supervision s'appuie sur une intégration prise en charge par Centreon Engine et ne requiert pas de plugin.

Utiliser le connecteur de supervision​

Utiliser un modèle d'hôte issu du connecteur​

  1. Ajoutez un hĂ´te Ă  Centreon depuis la page Configuration > HĂ´tes.
  2. Complétez les champs Nom, Alias & IP Address/DNS correspondant à votre ressource.
  3. Appliquez le modèle d'hôte App-Dynamics-AX-CMA-custom. Une liste de macros apparaît. Les macros vous permettent de définir comment le connecteur se connectera à la ressource, ainsi que de personnaliser le comportement du connecteur.
  4. Renseignez les macros désirées. Attention, certaines macros sont obligatoires.
MacroDescriptionValeur par défautObligatoire
SYSTEMLANGUAGELanguage installed on the Dynamics365 system.en
CENTREONAGENTPLUGINSPath where the centreon_plugins.exe plugin can be found.C:/Program Files/Centreon/PluginsX
  1. Déployez la configuration. L'hôte apparaît dans la liste des hôtes supervisés, et dans la page Statut des ressources. La commande envoyée par le connecteur est indiquée dans le panneau de détails de l'hôte : celle-ci montre les valeurs des macros.

Utiliser un modèle de service issu du connecteur​

  1. Si vous avez utilisé un modèle d'hôte et coché la case Créer aussi les services liés aux modèles, les services associés au modèle ont été créés automatiquement, avec les modèles de services correspondants. Sinon, créez les services désirés manuellement et appliquez-leur un modèle de service.
  2. Renseignez les macros désirées (par exemple, ajustez les seuils d'alerte). Les macros indiquées ci-dessous comme requises (Obligatoire) doivent être renseignées.

Analyse les fichiers d'une arborescence de répertoires, applique des filtres et évalue les métadonnées des fichiers (taille, horodatage, version, nombre de lignes, etc.) à des fins de surveillance et d'alerte.

MacroDescriptionObligatoireValeurs autoriséesValeur par défautExemples
PATHSRoot directory to search files in.XC:/RIS/Import/RIS General Ledger/Inputpath/to/file
PATTERNShell-style wildcards pattern to match filenames.
* can be used as a wildcard		*.xlsx
MAXDEPTHMax recursion depth.- 0: top only
- 1: include subdirs
- -1: recursively include all subdirs		0
OUTPUTSYNTAXOutput format string for the overall check result.Placeholders: {status}, {count}, {total}, {list}, {warn_count}, {warn_list}, {crit_count}, {crit_list}, {problem_count}, {problem_list}, {ok_count}, {ok_list}${status}: ${problem_count}/${count} files (${problem_list})
DETAILSYNTAXFormat for each file detail inside {list}.{path}, {filename}, {size}, {creation}, {access}, {written}, {version}, {line_count}, {extension}.${name}
OKSYNTAXOutput if all files are OK.{status}: {ok_count} files found - {ok_list}
FILTERFilter expression to select files for the check.nonesize > 1M && extension == '.dll'
WARNINGSTATUSFilter expression: files matching are considered WARNING.
CRITICALSTATUSFilter expression: files matching are considered CRITICAL.
WARNINGWARNING status items count must be strictly higher than this value to trigger WARNING.count > 50 = at least 1 file to trigger alert
CRITICALCRITICAL status items count must be strictly higher than this value to trigger CRITICAL.age > -1d or count > 200 = at least 1 file to trigger alert
VERBOSEDisplay detailed file info.false
TIMEOUTSet timeout for command execution120

Filter expressions​

Applies for FILTER, WARNINGSTATUS, CRITICALSTATUS.

Filter syntax is similar to C/SQL:

  • Numeric operators: ==, !=, >, <, >=, <=
  • Logical: && (AND), || (OR)
  • String equality: ==, != (note: single = is not valid)
  • IN/NOT IN: filename in ('myfile.txt'), version in ('1.0', '1.1')

Supported file metadata labels:

  • size (in bytes, supports units: K, Ko, M, Mo, G, Go)
  • line_count (line counting in txt file)
  • creation (file age in seconds since creation, supports units : w, d, h, m, s) no unit = s. Unit can’t be composed (ie : 1d3h)
  • access (file age in seconds since last access, supports units : w, d, h, m, s) no unit = s. Unit can’t be composed (ie : 1d3h)
  • written (file age in seconds since last modification, supports units : w, d, h, m, s) no unit = s. Unit can’t be composed (ie : 1d3h)
  • filename (name of the file, string comparison)
  • path (full file path, string comparison)
  • extension (file extension, e.g. '.dll')
  • version (for .exe/.dll files, string comparison)

You can also add this result list filter in WARNINGSTATUS and CRITICALSTATUS:

  • count number of items

Warning and Critical Status​

Files matching the WARNINGSTATUS/CRITICALSTATUS filters are considered WARNING/CRITICAL. You can combine with WARNING/CRITICAL to require multiple matches before changing the global state.

Examples​

Filters​

Applies for FILTER, WARNINGSTATUS, CRITICALSTATUS.

  • "size > 50M" # File larger than 50 MB
  • "extension == '.bak'" # Backup files
  • "size > 200m && extension == '.dll'" # Large DLLs
  • "count <= 0" # No file found
  • "filename in ('myfile.txt')" # Specific file by name
  • "filename == 'myfile.txt'" # Specific file by name (alternative)

File age check​

File age can be checked using 3 metadata labels, which can be mixed using logical operators :

  • creation (file age in seconds since creation, supports units : w, d, h, m, s) no unit = s. Unit can’t be composed (ie : 1d3h)
  • access (file age in seconds since last access, supports units : w, d, h, m, s) no unit = s. Unit can’t be composed (ie : 1d3h)
  • written (file age in seconds since last modification, supports units : w, d, h, m, s) no unit = s. Unit can’t be composed (ie : 1d3h)

"I want to trigger a CRITICAL alert if at least one file of my test directory has not be updated since 1 day or more, and WARNING alert if more than 12 hours and less than 1 day"

PATH= C:/Users/User/Documents/test
PATTERN= *.*
MAXDEPTH= -1,
DETAILSYNTAX= {filename}: {size}
WARNINGSTATUS= written > 12h
CRITICALSTATUS= written > 1d
WARNING= 0
CRITICAL= 0

File size check​

"I want to trigger a CRITICAL alert if at least 1 DLL in System32 (including subdirs without recursivity) size is >100M, and trigger a WARNING alert if at least 2 DLLs size is >10M"

The extension filter can be done using PATTERN or FILTER.

PATH= C:/Windows/System32
PATTERN= *.dll
MAXDEPTH= 1,
OUTPUTSYNTAX= {status}: {problem_count}/{count} DLLs have issues: {problem_list}
DETAILSYNTAX= {filename}: {size} {version}
FILTER= extension == '.dll'
WARNINGSTATUS= size > 10m
CRITICALSTATUS= size > 100m
WARNING= 1
CRITICAL= 0

Note:

  • If "line_count" is used in any filter or output, line count calculation will be enabled (may impact performance).
  • Paths, patterns, and filters are case-insensitive on Windows.
  • Use / as the path separator instead of \ (e.g., C:/Users/...). Backslashes require extra escaping and may cause errors.

File presence check​

"I want to trigger a CRITICAL alert if file is not present"

PATH= C:/Users/User/Documents/test
PATTERN= myfile.txt
MAXDEPTH= -1,
DETAILSYNTAX= {filename}: {size}
WARNINGSTATUS=
CRITICALSTATUS= count < 0
WARNING=
CRITICAL= 0

"I want to trigger a CRITICAL alert if at least one file is present"

PATH= C:/Users/User/Documents/test
PATTERN= myfile.txt
MAXDEPTH= -1,
DETAILSYNTAX= {filename}: {size}
WARNINGSTATUS=
CRITICALSTATUS= count > 0
WARNING=
CRITICAL= 0
  1. Déployez la configuration. Le service apparaît dans la liste des services supervisés, et dans la page Statut des ressources. La commande envoyée par le connecteur est indiquée dans le panneau de détails du service : celle-ci montre les valeurs des macros.