implement the prerequisites described in the documentation: Azure and Office365 monitoring pre-requisites
The Office 365 web portal provides reports on the use of the various services available.
These reports are visible in the Office 365 Administration Center in the “Reports” > “Usage” tab
Here are the services that provide reports on their use.
Full API documentation: https://docs.microsoft.com/en-us/graph/api/resources/report?view=graph-rest-1.0.
In general, these are metrics visible in graphs.
Number of files by type of activity.
Number of shares by type.
These two examples can be found in the Microsoft Graph API documentation:
The response of the API contains the same information as on the graphs in the web interface:
For OneDrive, we find the fields: Display or Modification, Synchronized, Shared internally, Shared externally.
These are the metrics in the tables below the charts.
They provide service usage information for each user.
Number of files by activity type for each user.
There is one line per user.
At the API level, on the Microsoft site for this example: https://docs.microsoft.com/en-us/graph/api/reportroot-getonedriveactivityuserdetail?view=graph-rest-1.0&tabs=cs
The response from the API contains the field “User Principal Name”, sign that there will be one line per user.
We find the fields present in the table visible on the web interface.
Available since version 4.1, ServiceNav offers the Office365-Generic service template for collecting overall usage data for a service.
The monitoring of usage data of a service per user will be possible using a service template that will be available in a future version.
As mentioned above, the Office365-Generic service model allows you to monitor only the global usage data of a service.
How to determine if a metric is available via this plugin or not?
To do so, two means available:
Example for Office365 license activations:
2. Go to the API Microsoft Graph documentation. Select the service and metric you wish to monitor.
For example, the number of Office365 license activations:
If in the answer there is no “User Principal Name” field then supervision is possible with the Office365-Generic service model.
Once assured that the metric is compatible with the plugin, we can move to the setting of the checkpoint.
The checkpoint is intended as generic as possible to retrieve the maximum amount of information. It will therefore be necessary to set it as needed.
In the following example, we will monitor the global storage used in the OneDrive service.
Here are the parameters of the checkpoint:
It is possible to fill several fields separated by the pipe symbol “|” in case the plugin has to do a calculation. The values will be stored in variables $ VAR1, $ VAR2, $ VAR3, etc … according to the order defined in the parameter.
The result in ServiceNav:
Information displayed in Dataviz dashboards: