Skip to main content

Use the Audit Log

When multiple users are working in the BigPanda platform, it’s vital to see historic information on system configuration changes. The Audit Log enables BigPanda admins to keep track of configuration change actions across the BigPanda platform. Using the Audit Log, admins can search for specific actions and filter the list of actions based on criteria such as timeframe, users, and action categories.

BigPanda audit logs reports on Create, Update, and Delete actions for these resources:

  • Alert Correlation

  • Alert Enrichment

  • Alert Filtering

  • API Keys

  • AutoShare

  • Environments

  • Integrations

  • JIT Provisioning

  • Maintenance Plans

  • Roles

  • SAML Attribute Mapping

  • SSO Configuration

  • SSO Test

  • User Management

Actions are added to the audit log in near real-time, appearing as the action is completed in the system.

Audit Log retention

BigPanda retains audit log data for the duration of your contract. See the Data Retention documentation for more information about retention policies.

Change tracking

Audit logs track changes to specific fields for each resource. Changes to other fields (such as a permissions change for an environment) will not be visible in the audit log.

Coming soon

Additional resources within BigPanda will be coming to the audit logs soon.

https://files.readme.io/9327dbd-Audit_Log.png

Audit Logs can also be accessed via API. See the Audit Logs API documentation for more information.

Key features

  • View a list of configuration changes and actions that occurred within BigPanda.

  • Determine which user made a configuration change to the system.

  • Sort and drill down into specific actions

  • Filter logs and search for a specific action.

Relevant Permissions

Roles with the following permissions can access the Audit Logs screen:

Field

Description

Audit logs

View the Audit Log in BigPanda Settings and the Audit Log API.

Permission access levels can be adjusted by selecting either View or Full Access. To learn more about how BigPanda's permissions work, see the  Roles Management guide.

View the Audit Log

The Audit Log can be accessed from within BigPanda at Settings > Audit Log. The following information appears in the Audit Log screen:

Field

Description

User

The name and email address of the user associated with the action.

Action

The action that took place. Possible actions include Created, Updated, or Deleted.

Category

The screen in BigPanda where the action took place.

Object Name

The name of the object that was changed as part of the action.

Date

The date and time that the action took place.

To view additional details, click any action in the list on the Audit Log page. Detailed information about the changed object and the user who made the change appears on the page.

https://files.readme.io/4f0eb9e-Settings_AuditLog_DrillDown.png

Audit Log Details

Filter

The Audit Log can be filtered by User, Action, Category, Object Name, or Date to adjust your results.

To filter the Audit Log, select one of the options above the Audit Log table. Depending upon the filter selected, choose an option from the drop-down menu, or type into the box to narrow the results. Multiple filters can be applied at the same time.

To remove all filters, click Clear All.

Sort

The Audit Log can be filtered by User, Action, Category, Object Name, or Date to change the order of your results. From within the Audit Log table, select one of the options from the top of each column to change the sort order.

Sort is turned off when you are drilled down into a log. To change sort options for the list, collapse the selected log by clicking the down arrow in the log detail ribbon.

User Information

At the bottom of the details of each action, information about the BigPanda user who made the change appears. The following information about the user is available:

Field

Description

User Name

The name of the user.

Email

The user’s email address

IP Address

The user’s IP address.

User Agent

The browser and version that was used when the change occurred.

Available Resources

Audit logs track actions taken on individual resources within BigPanda. The following resources are available to track via the audit log:

Alert Correlation

Correlation patterns allow you to correlate related alerts into incidents for visibility into high-level, actionable issues. For more information, see Manage Alert Correlation.

Field

Description

Category

The name of the resource.

Object Name

The correlation pattern associated with the action.

Action

The type of action that occurred, along with the date and time it happened.

Correlation Pattern ID

System-generated unique identifier for the correlation pattern.

Status

Indicates whether the correlation pattern is Active or Inactive.

Cross Source

Determines if alerts can be correlated from different source systems into the same incident.

Correlation Tags

The tag names used to correlate alerts with matching values.

Time Window

Maximum duration between the start time of correlated alerts in minutes.

Query Filter

A BPQL query to filter incoming alerts. Only matched alerts will be correlated based on the pattern.

Description

A description of the correlation pattern.

Alert Enrichment

Enrichment is the process of adding contextual information to alerts in BigPanda. See Manage Alert Enrichment for more information.

Alert Enrichment Audit logs report on several sub-objects including:

  • Tag

  • Tags Order

  • Tag Enrichments

  • Tag Enrichments Order

  • Mapping Enrichment

  • Mapping Table Upload

Tag

Field

Description

Category

The name of the resource.

Object Name

The name of the tag.

Action

The type of action that occurred, along with the date and time it happened.

Tag ID

The name of the tag in BigPanda.

Status

Indicates the tag’s status in the system. Statuses include Active, Inactive, or Deleted.

Function Type

Automatic Enrichment rule type. Function types include Composition, Extraction, Mapping, or Mixed.

Execution Order

Number indicating the tag’s place in the execution order.

Automatic Enrichment

Click View full details to view additional information about the enrichment items.

Tags Order

Field

Description

Category

The name of the resource.

Object Name

The name of the tag

Action

The type of action that occurred, along with the date and time it happened.

Tags Order ID

The tag order ID.

Status

Indicates the tag’s status in the system. Statuses include Active, Inactive, or Deleted.

Tag Enrichments

Field

Description

Category

The name of the resource.

Object Name

The name of the enrichment item.

Action

The type of action that occurred, along with the date and time it happened.

Tag Enrichments ID

The tag enrichment ID.

Status

Indicates the tag’s status in the system. Statuses include Active, Inactive, or Deleted.

Function Type

Automatic Enrichment rule type. Function types include Composition or Extraction.

Automatic Enrichment

Click View full details to view additional information about the enrichment items.

Tag Enrichments Order

Field

Description

Category

The name of the resource.

Object Name

The name of the enrichment item.

Action

The type of action that occurred, along with the date and time it happened.

Tag Enrichments Order ID

The tag enrichment order ID.

Status

Indicates the tag’s status in the system. Statuses include Active, Inactive, or Deleted.

Mapping Enrichment

Field

Description

Category

The name of the resource.

Object Name

The name of the map.

Action

The type of action that occurred, along with the date and time it happened.

Mapping Enrichment ID

The tag mapping enrichment ID.

Status

Indicates the tag’s status in the system. Statuses include Active, Inactive, or Deleted.

Mapping Table Upload

Field

Description

Category

The name of the resource.

Object Name

The name of the map.

Action

The type of action that occurred, along with the date and time it happened.

Mapping Table Upload ID

The mapping table upload ID.

Status

Indicates the tag’s status in the system. Statuses include Active, Inactive, or Deleted.

Alert Filtering

Alert filtering allows you to prevent low-relevancy alerts from being correlated into incidents. See Manage Alert Filtering for more information.

Field

Description

Category

The name of the resource.

Object Name

The name of the alert filter associated with the action.

Action

The type of action that occurred, along with the date and time it happened.

User

Unique system identifier for the user.

Alert Filtering ID

The ID for the alert filter associated with the action.

Status

Indicates whether the alert filter is currently active.

Filter Name

Name of the alert filter.

Time Window

Details of the alert filter's time window.

API Keys

API Keys are used to securely authenticate calls to the BigPanda Public API.

Field

Description

Category

The name of the resource.

Object Name

The name of the API key associated with the action.

Action

The type of action that occurred, along with the date and time it happened.

API Key ID

The system-generated ID associated with the API key.

Status

Indicates whether the API key is active or not. 

AutoShare

AutoShare rules can be configured to share BigPanda incidents through email or integrated channels to notify your team of critical issues, automatically create tickets, or loop in team members who don’t use BigPanda. See Manage AutoShare for more information.

Field

Description

Category

The name of the resource.

Object Name

The sharing channel associated with the action.

Action

The type of action that occurred, along with the date and time it happened.

AutoShare ID

System-generated unique identifier for the AutoShare rule

Status

Indicates whether the environment is Active or Inactive.

Environment

The environment that the incident was shared from.

Share Via

The sharing channel that the incident was shared to.

Personal message

An optional note adding context to the AutoShare rule.

Environment

Environments group related incidents together for improved automation and visibility. See Manage Environments for more information.

Field

Description

Category

The name of the resource.

Object Name

The environment associated with the action.

Action

The type of action that occurred, along with the date and time it happened.

Environment ID

System-generated unique identifier for the environment

Status

Indicates whether the environment is Active or Inactive.

Environment name

The name of the environment as displayed in the BigPanda UI

Condition

A BPQL query to filter incoming incidents. Only matched incidents will be placed in the environment.

Integrations

Integrations allow you to shorten and automate incident triage by creating high quality alerts and actionable incidents. For more information, see Integrate with BigPanda.

Field

Description

Category

The name of the resource.

Object Name

The integration associated with the action.

Action

The type of action that occurred, along with the date and time it happened.

Target System ID

Name that uniquely defines an integration.

Stream ID

System-generated unique app_key for the integration.

Status

Indicates whether the integration is Active or Inactive.

Organization

The name of the BigPanda Organization where the update occurred.

Changes

List of updated configuration properties.

JIT Provisioning

JIT Provisioning allows you to define the domains associated with your IdP, and select default BigPanda user roles for newly created accounts from each SSO domain.

Field

Description

Category

The name of the resource.

Object name

The domain associated with the action.

Action

The type of action that occurred, along with the date and time it happened.

JIT Provisioning ID

The unique system-generated ID associated with the JIT mapping.

Status

Indicates whether the configuration is Active or Inactive.

Maintenance Plans

Maintenance plans reduce unnecessary noise by marking and silencing alerts triggered by system maintenance. See Manage Planned Maintenance for more information.

Field

Description

Category

The name of the resource.

Object Name

The name of the maintenance plan associated with the action.

Action

The type of action that occurred (Created, Updated, or Deleted), along with the date and time it happened.

User

Unique system identifier for the user.

Maintenance Plan ID

The ID for the maintenance plan associated with the action.

Status

Indicates the current status of the maintenance plan.

Plan Name

Name of the maintenance plan.

Time Window

Details of the maintenance plan's time window and whether or not it's recurring. 

Roles

Roles and permissions control the levels of access to different features in BigPanda.

Field

Description

Category

The name of the resource.

Object name

The role associated with the action.

Action

The type of action that occurred, along with the date and time it happened.

Role ID

System-generated unique identifier for the role.

Status

Indicates whether the role is Active or Inactive.

Name

The name of the role.

SAML Attribute Mapping

With SAML Attribute Mapping, you can use properties from your IdP to automatically map roles to an account in BigPanda whenever an existing user logs in.

Field

Description

Category

The name of the resource.

Object name

The domain associated with the action.

Action

The type of action that occurred, along with the date and time it happened.

JIT Provisioning ID

Unique system identifier for this mapping.

Status

Indicates whether the configuration is Active or Inactive.

SSO Configuration

You can configure an SSO integration to manage your organization’s BigPanda users via a third-party identity provider. See Single Sign-On for more information.

Field

Description

Category

The name of the resource.

Object Name

The correlation pattern associated with the action.

Action

The type of action that occurred, along with the date and time it happened.

SSO Configuration ID

The identity provider used in the SSO configuration.

Status

Indicates whether the SSO configuration is Active or Inactive.

SSO Test

SSO Test tracks when a user tests the SSO connection from the Single Sign-On screen during the configuration process.

Field

Description

Category

The name of the resource.

Object Name

The SSO domain associated with the action.

Action

The type of action that occurred, along with the date and time it happened.

SSO Test ID

The name of the SSO provider.

Status

The status of the SSO configuration.

User Management

User management allows administrators to manage who can access your organization's data in BigPanda. See User Management for more information.

Field

Description

Category

The name of the resource.

Object Name

The user name associated with the action.

Action

The type of action that occurred, along with the date and time it happened.

User ID

Unique system identifier for the user.

Status

Indicates the user’s status in the system. Statuses include Active or Pending.

User Name

The name of the user as displayed in the BigPanda UI.

Email

The email address associated with the user.