Aller au contenu principal

Azure ExpressRoute

Prerequisites

Centreon Plugin

Install this plugin on each needed poller:

yum install centreon-plugin-Cloud-Azure-Network-ExpressRoute-Api

Perl dependencies (for 'api' custom mode)

By installing the plugin, some perl depencies will be installed :

JSON::XS
DateTime
Digest::MD5
Digest::SHA
LWP::UserAgent
LWP::Protocol::https
IO::Socket::SSL
URI
HTTP::ProxyPAC

The login and access token handling will be made by the plugin itself.

Azure CLI 2.0 (for 'azcli' custom mode)

The CLI needs at least Python version 2.7 (https://github.com/Azure/azure-cli/blob/dev/doc/install_linux_prerequisites.md).

On CentOS/RedHat, install with following commands:

(As root)
# rpm --import https://packages.microsoft.com/keys/microsoft.asc
# echo -e "[azure-cli]\nname=Azure CLI\nbaseurl=https://packages.microsoft.com/yumrepos/azure-cli\nenabled=1\ngpgcheck=1\ngpgkey=https://packages.microsoft.com/keys/microsoft.asc" > /etc/yum.repos.d/azure-cli.repo
# yum install azure-cli
(As centreon-engine)
# az login

The shell should prompt:

To sign in, use a web browser to open the page https://microsoft.com/devicelogin and enter the code CWT4WQZAD to authenticate.

Go to https://microsoft.com/devicelogin and enter the given code.

Log in with your account credentials. You should use a service account. Application is not yet supported.

The command line should now show:

[
{
"cloudName": "AzureCloud",
"id": "0ef83f3a-d83e-2039-d930-309df93acd93d",
"isDefault": true,
"name": "N/A(tenant level account)",
"state": "Enabled",
"tenantId": "0ef83f3a-03cd-2039-d930-90fd39ecd048",
"user": {
"name": "email@mycompany.onmicrosoft.com",
"type": "user"
}
}
]

You now have a hidden azure directory where your token is stored in an accessTokens.json file.

Centreon Configuration

Create a new host

Go to Configuration > Hosts and click Add. Then, fill the form as shown by the following table:

FieldValue
Host nameName of the host
AliasHost description
IPHost IP Address
Monitored fromMonitoring Poller to use
Host Multiple TemplatesCloud-Azure-Network-ExpressRoute-custom

Click on the Save button.

Set host macros

The following macros must be configured on host.

Common macros

MacroDescription
AZURECIRCUITNAMECircuit name
AZURERESOURCEGROUPResource group

'api' custom mode macros

MacroDescription
AZURECUSTOMMODECustom mode 'api'
AZURESUBSCRIPTIONSubscription ID
AZURETENANTTenant ID
AZURECLIENTIDClient ID
AZURECLIENTSECRETClient secret

'azcli' custom mode macros

MacroDescription
AZURECUSTOMMODECustom mode 'azcli'
AZURESUBSCRIPTIONSubscription ID

Click on the Save button.

Available metrics

Go to https://docs.microsoft.com/en-us/azure/monitoring-and-diagnostics/monitoring-supported-metrics?toc=/azure/azure-monitor/toc.json#microsoftnetworknetworkinterfaces to see the description of return metrics for this Azure service.