Activity

The M365 Plugin Activity module protects various reports concerning user activity and usage within m365.

The information protected with this module is detailed below:

  • m365GroupsActivityStorage

  • m365GroupsActivityDetail

  • m365ActiveUserDetail

  • m365ActivationsUserDetail

  • m365AppUserDetail

  • yammerDeviceUsageUserDetail

  • yammerActivityUserDetail

  • yammerActivityGroupsDetail

  • teamsDeviceUsageUserDetail

  • teamsActivityUserDetail

  • teamsActivityGroupDetail

  • skypeDeviceUsageUserDetail

  • skypeActivityUserDetail

  • sharepointSiteUsageStorage

  • sharepointSiteUsageDetail

  • sharepointActivityUserDetail

  • oneDriveUsageStorage

  • oneDriveUsageAccountDetail

  • oneDriveActivityUserDetail

  • mailboxUsageStorage

  • mailboxUsageDetail

  • emailAppUsageUserDetail

  • emailActivityUserDetail

The catalog stores the information with the following structure:

  • /@m365/tenantName/activity/

    • reportName.csv

Note

The activity module is available since Bacula 18.0.1.

Backup Parameters

The following list shows the specific backup parameters that can be set up in order to control the behavior of the activity module.

In order to select the chat module, the common service parameter must be or contain the value activity.

Option

Required

Default

Values

Example

Description

activity_exchange

No

Yes

0, no, No, false, FALSE, false, off ; 1, yes, Yes, TRUE, true, on

No

Include exchange/mailbox-related reports

activity_onedrive

No

Yes

0, no, No, false, FALSE, false, off ; 1, yes, Yes, TRUE, true, on

No

Include onedrive-related reports

activity_sharepoint

No

Yes

0, no, No, false, FALSE, false, off ; 1, yes, Yes, TRUE, true, on

No

Include sharepoints-related reports

activity_teams

No

Yes

0, no, No, false, FALSE, false, off ; 1, yes, Yes, TRUE, true, on

No

Include teams-related reports

activity_yammer

No

Yes

0, no, No, false, FALSE, false, off ; 1, yes, Yes, TRUE, true, on

No

Include yammer-related reports

activity_skype

No

Yes

0, no, No, false, FALSE, false, off ; 1, yes, Yes, TRUE, true, on

No

Include skype-related reports

activity_general

No

Yes

0, no, No, false, FALSE, false, off ; 1, yes, Yes, TRUE, true, on

No

Include general m365 service-related reports

activity_period_days

No

180

7, 30, 90, 180

90

Period of days ‘from’ used to generate the report. Only documented values are allowed

activity_from

No

date formatted like: yyyy-MM-dd_HH:mm:ss

2024-01-01_00:00:00

Date ‘from’ used to generate the reports. This method only permits values from the last 30 days

One recommended strategy to protect the information of these reports is to define a supported period, such as 1 week. Then, activity_period_days can be set to 7 and run weekly. This way, the reports will contain only updated information each time, avoiding duplicate entries.

Restore Parameters

Restore of reports can only be performed to a local filesystem to the File Daemon. Therefore, ‘where’ restore parameter should point to the destination directory where the information needs to be restored.

Fileset Examples

Backup all reports:

Fileset Example
FileSet {
        Name = fs-m365-reports
        Include {
                Options { signature = MD5 }
                Plugin = "m365: service=activity tenant=57uia43-d107-17a2-a2g2-aa53c10tdahc objectid=56ddf1h9-eb5d-42nf-bac7-7b019fd284g5"
        }
}

Backup reports of the last week:

Fileset Example
FileSet {
        Name = fs-m365-peter-chat-noimages
        Include {
                Options { signature = MD5 }
                Plugin = "m365: service=activity tenant=57uia43-d107-17a2-a2g2-aa53c10tdahc objectid=56ddf1h9-eb5d-42nf-bac7-7b019fd284g5 activity_period_days=7"
        }
}