Skip to main content

Dynamics365 CMA

Connector dependencies​

The following monitoring connectors will be installed when you install the Dynamics365 CMA connector through the Configuration > Connectors > Monitoring Connectors menu:

Pack assets​

Templates​

The Monitoring Connector Dynamics365 CMA brings a host template:

  • App-Dynamics-365-CMA-custom

The connector brings the following service templates (sorted by the host template they are attached to):

Service AliasService TemplateService DescriptionType of check
New-OrdersApp-Dynamics-365-New-Orders-CMA-customCheck new orders presence and agenatif

The services listed above are created automatically when the App-Dynamics-365-CMA-custom host template is used.

Collected metrics & status​

Here is the list of services for this connector, detailing all metrics linked to each service.

NameUnit
critical_countcount
warning_countcount
ok_countcount

Prerequisites​

Network flow​

Only one TCP flow must be open from the host to the poller.

SourceDestinationProtocolPortPurpose
Monitored hostCollecteurTCP4317Configuration retrieval, and OpenTelemetry data flow

System prerequisites on the poller​

To be able to use the Centreon Monitoring agent, you must use a poller with at least version 24.10 for On Prem users of centreon-engine. The Centreon Monitoring agent will configure itself by connecting to Centreon Engine.

Configure Engine​

Configure how the poller and the agent will communicate. (This link directs you to the latest version of the OnPrem documentation. Use the version selector in the top right corner to switch to another version if you need to.)

System prerequisites on the monitored host​

The installer can be downloaded from the centreon-collect's releases page.

Installing the Centreon Monitoring Agent​

The installation and configuration procedure of the Centreon Monitoring Agent is detailed in this dedicated page. This includes installing the agent, and installing the plugins that will execute the non-native checks. (This link directs you to the latest version of the OnPrem documentation. Use the version selector in the top right corner to switch to another version if you need to.)

Installing the monitoring connector​

Pack​

The installation procedures for monitoring connectors are slightly different depending on whether your license is offline or online.

  1. If the platform uses an online license, you can skip the package installation instruction below as it is not required to have the connector displayed within the Configuration > Monitoring Connectors Manager menu. If the platform uses an offline license, install the package on the central server with the command corresponding to the operating system's package manager:
dnf install centreon-pack-applications-dynamics-365-cma

  1. Whatever the license type (online or offline), install the Dynamics365 CMA connector through the Configuration > Monitoring Connectors Manager menu.

  2. According to your version of Centreon, skip to the next step or create a connector on your central server.

For this version, no configuration is needed. Move on to the next step.

Plugin​

This connector relies on an integration supported by Centreon Engine and does not need a plugin.

Using the monitoring connector​

Using a host template provided by the connector​

  1. Log into Centreon and add a new host through Configuration > Hosts.
  2. Fill the Name, Alias & IP Address/DNS fields according to your ressource settings.
  3. Apply the App-Dynamics-365-CMA-custom template to the host. A list of macros appears. Macros allow you to define how the connector will connect to the resource, and to customize the connector's behavior.
  4. Fill in the macros you want. Some macros are mandatory.
MacroDescriptionDefault valueMandatory
SYSTEMLANGUAGELanguage installed on the Dynamics365 system.en
CENTREONAGENTPLUGINSPath where the centreon_plugins.exe plugin can be found.C:/Program Files/Centreon/PluginsX
  1. Deploy the configuration. The host appears in the list of hosts, and on the Resources Status page. The command that is sent by the connector is displayed in the details panel of the host: it shows the values of the macros.

Using a service template provided by the connector​

  1. If you have used a host template and checked Create Services linked to the Template too, the services linked to the template have been created automatically, using the corresponding service templates. Otherwise, create manually the services you want and apply a service template to them.
  2. Fill in the macros you want (e.g. to change the thresholds for the alerts). Some macros are mandatory (see the table below).

Checks files in a directory tree, applies filters, and evaluates file metadata (size, timestamps, version, line count, etc.) for monitoring and alerting.

MacroDescriptionMandatoryAllowed valuesDefault valueExamples
PATHSRoot directory to search files in.XC:/D365/Interfaces/Input/SalesOrders/New/path/to/file
PATTERNShell-style wildcards pattern to match filenames.
* can be used as a wildcard		*.xml
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}: All {count} files are ok
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 > 200 = 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 > 1000 = at least 1 file to trigger alert
VERBOSEDisplay detailed file info.
  1. Deploy the configuration. The service appears in the list of services, and on page Resources Status. The command that is sent by the connector is displayed in the details panel of the service: it shows the values of the macros.

Troubleshooting​

Please find the troubleshooting documentation for the API-based plugins in this chapter if you cannot find the solution to your issue below.