System Logs
Microsoft General Audit Logs
Beta Feature
This input is currently in beta. If you run into any issues, please reach out to product@monad.com.
Provides general Office 365 audit events from workloads not covered by other audit categories.
Sync Type: Incremental
Requirements
Before setting up the input you need to:
- In Microsoft Purview, turn auditing on.
- Create a Microsoft Entra app registration:
- Supported account types: Accounts in this organizational directory only.
- Certificates & secrets: Create a new client secret and copy its Value. You will need it to configure the Monad input.
- Grant the application access to the Office 365 Management APIs:
- Under API permissions → Add a permission → APIs my organization uses, search for Office 365 Management APIs.
- Add
ActivityFeed.Readas an Application permission (not Delegated). - Click Grant admin consent for <your tenant>.
The input starts the Office 365 Management Activity subscription for its content type itself, so you don't need to start it. Microsoft can take up to 12 hours to make content available after a subscription is first started.
Backfill and sync window
- The first sync starts from now and collects no history, unless you set a Backfill Start Time.
- A Backfill Start Time can reach back at most 7 days; an earlier start time is treated as 7 days ago.
- Each sync then continues from the newest content it has collected.
Configuration
Settings
| Setting | Type | Required | Default | Description |
|---|---|---|---|---|
tenant_id | string | Yes | - | The tenant ID of the Entra ID directory associated with your Azure subscription. |
use_synthetic_data | bool | No | false | Generate synthetic data for testing, instead of connecting to a real data source. Defaults to an hourly cron schedule for cron-based inputs. |
backfill_start_time | date | No | - | The date to start fetching data from. If not specified, no past records will be fetched. |
rate_limit | object | No | - | Maximum outbound source-API request rate. A blank or zero value falls back to the connector's default rate-limiting behavior. Maximum 10 requests per second. See API Rate Limiting for the field format. |
Secrets
| Secret | Type | Required | Description |
|---|---|---|---|
client_id | secret | Yes | The client ID of the Entra ID application |
client_secret | secret | Yes | The client secret of the Entra ID application |
Related Articles
Sync frequency
By default this input polls approximately every 10 seconds, with each sync beginning after the previous one completes. A cron schedule configured on the pipeline overrides this cadence. See Input Sync Frequency for details.
Last modified on