Chat now with support
Chat with Support

Foglight for Exchange 5.7.2.3 - Foglight for Office 365 User Guide

Start and stop data collection

To start data collection for a Foglight for Office 365 agent or a ADFS agent:
1
Select the agent instance in the Agents management table.
2
Click Start Data Collection.
If the operation is successful, the Collecting Data column for that agent is changed to display the Collecting Data icon.
If the operation is not successful, a dialog box opens recommending to review the agent log files for details. Click OK to close this dialog box.
 
* 
NOTE: To download or open the agent log file, click the Download Log File icon in the Log File column for a select agent.
To stop data collection for a Foglight for Office 365 agent or a ADFS agent:
1
Select the agent instance in the Agents management table.
2
Click Stop Data Collection.
If the operation is successful, the Collecting Data column for that agent is changed to display the Not Collecting Data icon.

Configure domain credentials

To configure the credentials for a Foglight for Office 365 agent:
1
Select a Foglight for Office 365 agent instance in the Agents management table.
2
Click the Edit icon on the Credentials column.
The Edit Domain Credentials dialog box appears.
3
On the Assign and Validate Domain Credentials page, review the available credentials, and edit them, as necessary.
•
To create a new credential, click Add domain to a new credential.
a
In the Create New Credential and Assign dialog box, create a credential that you want to use to access the monitored resource. Type a new credential name.
b
Type in a user name, password, and select a lockbox to contain the credential.
c
Click Submit.
•
To select an existing credential, click Add domain to an existing credential.
•
In the Select Existing Credential dialog box, select an existing credential, and click Submit.
4
Click Finish.
The Foglight for Office 365 agent credentials are now updated.

Set up permissions to use the Office 365 APIs

To update the consent to use Office 365™ APIs:
1
Select an Foglight for Office 365 agent instance in the Agents management table.
2
Click the Edit icon on the Consent column.
The Update Agent Permissions wizard appears.
3
On the Update Permissions for Office 365 page, carefully read the instructions about the steps that you need to take before proceeding with the wizard, then click the link Click here to go to Office 365 web page for application permission consent.
You are redirected to the Office 365™ login page.
4
Log into Office 365 using the credentials of an administrator account.
5
Obtain the Office 365 Admin Consent for a tenant application to be monitored. Review the following permissions:
•
Read activity data for your organization (Office 365 Management APIs)
•
Read activity reports for your organization (Office 365 Management APIs)
•
Read service health information for your organization (Office 365 Management APIs)
•
Read contacts in all mailboxes
•
Read calendars in all mailboxes
•
Read all users’ full profiles
•
Read all groups
•
Read directory data
•
View users’ email address
•
View users’ basic profile
•
Enable sign-on and read user’s profiles
Click Accept to complete the permission consent and be redirected to the Foglight login page, back to the Update Permissions for Office 365 wizard.
6
Click Finish.

Configuring Foglight for Office 365 agent properties

The properties of a Foglight for Office 365 agent are required to connect to Exchange Online environment from which data is to be collected. These properties are either specified when the agent instance is configured or have a default value.

To display an agent’s properties page:
1
From the navigation panel, navigate to Dashboards > Administration > Agents > Agent Status.
2
On the Agent Status dashboard, select an Office365Monitoring agent from the list and click Edit > Edit Properties.
The Agent Status dashboard refreshes, showing the current properties for the selected agent instance.
Figure 3. Office 365 agent properties

The following tables describe the properties that can be modified for either an individual Foglight for Office 365 agent instance or for all agent instances, by clicking Modify the private properties for this agent or Modify the properties of all Office365Agent agents links, respectively.

 
* 
NOTE: Configure the global agent properties for all agent instances first, then modify the private properties for any instances that require further configuration.

Use the specify the authcode and tenantid section to define the connection settings.

 
Table 3. Office365Monitoring agent properties - “specify the authcode and tenantid” section
Property
Default
Description

Domain Name

N/A

The fully qualified domain name (myServer.myDomain.com) of the Exchange Online environment from which data is to be collected.

Network Connection Timeout

51000

Specifies how long (milliseconds) the system waits for a response from the remote server before it times out. That is, the time in milliseconds that a data collection query will run before it is presumed to have failed and the network connection is terminated.

Max Process Email Count

100

Specifies the maximum amount of emails to be processed when populating the following metrics: Message Send/Receive Time and Message Success/Failed Count. For more information, refer to Environment Summary - Exchange Online (Selected Object) view .

 

The selection made in the Data Collection Scheduler section defines the data collection schedule to be used to collect performance metrics.

* 
NOTE: The settings in this section are global and apply to all agents of type Office365AgentMonitoring.

The following table lists the collectors being used by the cartridge and the default collection interval for each (as defined in the defaultSchedule).

.
 
Table 4. Office365Monitoring agent properties - Data Collection Scheduler section
Collector Name
Default Collection Interval

servicesHealth

4 minutes

exchangeOnline

1 hour

licenseInfo

30 minutes

userInfo

30 minutes

Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating