Last updated March 16, 2021

Enterprise Accounts enable you to export an audit trail, which is a chronological, JSON-formatted archive of certain events associated with the account. This archive helps you meet a variety of compliance, auditing, and accountability requirements.

Installation

No installation is needed for the Audit Trail. If you are using the Enterprise Accounts and have the “Manage” permission in your company’s Enterprise Account, you should be able to find and use feature under the Settings tab.

Usage

Heroku provides a separate event archive for each calendar month. It does not provide real-time event logging. If you request the event archive for the current month, the archive includes all events from the start of the current month up to midnight UTC of the current day.

First install the enterprise plugin:

$ heroku plugins:install @heroku-cli/plugin-enterprise

To list all available event archives:

$ heroku enterprise:audits -e my-enterprise-account-name

To export the current month’s archive:

$ heroku enterprise:audits:export -e my-enterprise-account-name

To export a particular month’s archive:

$ heroku enterprise:audits:export 2018-01 -e my-enterprise-account-name

Access

Any member of your Enterprise Account with the manage permission can export audit trail archives. Learn more about Enterprise Account permissions. Users can also export audit logs using the Enterprise Accounts CLI plugin. Please visit the Enterprise Accounts CLI Plugin Dev Center article to learn more about the Heroku CLI and installation instructions.

Supported events

Currently, audit trails include the following event types, selected to help you meet various auditing and compliance requirements:

[
  "addon.attach",
  "addon.create",
  "addon.destroy",
  "addon.detach",
  "addon.update",
  "app.create",
  "app.destroy",
  "app.update",
  "app_transfer.create",
  "app_transfer.update",
  "code_release.create",
  "collaborator.create",
  "collaborator.destroy",
  "config_change.remove",
  "config_change.set",
  "domain.create",
  "domain.destroy",
  "heroku_config_change.update",
  "sni_endpoint.create",
  "sni_endpoint.destroy",
  "sni_endpoint.update",
  "space.create",
  "space.destroy",
  "space.update",
  "ssl_endpoint.create",
  "ssl_endpoint.destroy",
  "ssl_endpoint.update",
  "team_membership.create",
  "team_membership.destroy",
  "team_membership.update",
  "team.destroy",
  "team.update"
]