View or download your audit logs

Audit logs maintain a record of specific activities in your flows, including the fields that were changed, the type of change, and who’s responsible for the change. You can view your audit logs at a flow or integration level.

Important: In audit logs, pageProcessors and pageGenerators represent imports and exports, respectively. It’s just a system naming convention that doesn’t affect your integrations or flows.

Audit logs

Account audit logs

Integration audit logs

These logs show high-level data for all your logs. To narrow down the information to integration audit logs, use Select resource type, user, and source.

Contents

• Download audit logs
• Practical uses for audit logs
• Parameters
  • Time
  • Source
  • User
  • Resource Type
  • Resource Name
  • Action
  • Field
  • Old and new values

Download audit logs

integrator.io keeps audit logs for a year. For example, if the current date is Jan 3, 2023, then you can view audit logs from Jan 3, 2022, to Jan 3, 2023. If you download logs to a CSV file or use the audit API endpoint, you can download up to 20,000 records simultaneously. If, for example, you’ve generated 30,000 records in the last 24 hours, you can download the records in parts by adjusting the Custom date/time range. You can also filter the logs by resource type, user, source, or action and then download the filtered list of records.

Practical uses for audit logs

It’s easy to review audit logs in a vacuum. However, you can use your audit logs to troubleshoot flow errors and pinpoint changes that created issues with your integration or flow. You can also determine who changed account permissions. For example, if someone changed an import field and caused an error, you can use audit logs to review the changes. Then, use Integration Lifecycle Management to revert your changes.

Parameters

Audit logs record every action or change you’ve made to your flow or integration. The logs record nine (9) parameters for each change:

Time

You can configure your account profile to display timestamps in any date/time format. If you’ve set your account to relative time, the timestamp is displayed as the length of time between the started date and time and the current date and time (1 day ago, 3 hours ago).

User

The user responsible for the changes. In cases where the account is shared by multiple people with the same password, the only username is something similar to “Account Owner” or your company name.

Tip: If you’re an account owner or administrator you can invite new users (or remove old users) to your account.

Source

Determines how the change was made. This could be:

• UI – Changes were made from the user interface.
• API – Changes were made in the API.
• Stack – Changes were made from the stack.
• System – Any change made to a resource by integrator.io backend logic or a system process.
• Integration app – Changes were made by the integration app.

Resource Type

Shows you the resource that was updated. There are nine resources monitored for changes:

There are also account-specific resources, including user status changes, deletions by each user and IP address, agent changes, and single sign-on logs.

To find these resources, click your profile at the top, right-hand side of the screen → click My Account → and click Audit log.

Resource Name

The name or identifier of your updated resource. Resources with IDs instead of names have been deleted, which is why they’re only available by the ID they were given when they were created.

Action

The action that was taken. Actions include:

• Create
• Update
• Delete
• Sign in
• Sign out
• View

The most common action is Update, while Create and Delete are reserved for creating/deleting a flow or another significant event. The Sign in and Sign out actions are reserved for the User resource.

Field

The Field column gives you an idea of what’s been changed. It can display things like pageProcessors, connections, and names.

Old and new values

The field values before and after the change.

In the Old and New value fields, you have options including Click to view edits, dates and times a token was updated, and secure connection details. You should know that we won’t display your secure connection details, like keys, tokens, or passwords, in audit logs under any circumstances, as those details are encoded.

When you use Click to view, old and new edits are displayed side-by-side in a popup diff screen. This is a feature of the flow audit log that’s also available in the integration logs. It drills down and shows you the exact changes you made, including any mapping changes.