Skip to main content

Audit Logs

Sync Type: Incremental

Overview​

The Akuity Audit Logs input collects comprehensive audit trail data from your Akuity Platform organization, providing visibility into organizational events, user actions, and system changes. This integration captures detailed logs including resource modifications, user activities, access patterns, timestamps, and actor information across your Akuity Portal.

Prerequisites​

1. Akuity Platform Account​

You must have access to an Akuity Platform Account with appropriate permissions to create API keys and access audit logs for your organization.

Important Security Note: Audit logs contain sensitive organizational data including user actions, resource changes, and system events. Ensure proper access controls are in place when configuring this integration and follow the principle of least privilege when creating API keys.

API Key Setup​

  1. Navigate to Organization Settings

    • Log into your Akuity Platform.
    • Select your organization from the dropdown menu in the top navigation bar.
    • Click on Organization in the left navigation panel.

  2. Access API Keys Section

    • Navigate to the API Keys tab within Settings

  3. Create New API Key

    • Click the + New Key button.
    • Provide a descriptive name for the key (e.g., "Monad Audit Logs Integration").
    • Optionally add a description explaining the key's purpose.
    • Assign an appropriate role with permissions to read audit logs.

  4. Save and Store Credentials

    • After creation, copy both the API Key ID and API Key Secret.
    • Store these credentials securely - the secret will not be displayed again.
    • Both values are required for authentication.

Configuration​

Settings​

SettingTypeRequiredDescription
Organization IDstringtrueThe unique identifier of your Akuity organization. Found in the organization settings or URL.
Backfill Start TimestringNoThe date to start fetching data from. If not specified, no past records will be fetched.

Secrets​

SettingTypeRequiredDescription
API Key IDstringtrueThe API Key ID from your Akuity Platform API key
API Key SecretstringtrueThe API Key Secret from your Akuity Platform API key

Authentication​

This integration uses HTTP Basic Authentication with the Akuity Platform API:

  • Username: API Key ID
  • Password: API Key Secret

The credentials are automatically encoded and sent in the Authorization header as Basic <base64-encoded-credentials>.

Data Collection​

  • Audit logs are collected incrementally based on timestamp.
  • Logs include actions such as resource creation, deletion, updates, and access events.
  • Each log entry contains timestamp, action type, actor information, and affected resources.

Sample Record​

{
    "action": "deleted",
    "actor": {
        "id": "Sarah Brown@akuity.io",
        "ip": "132.226.61.247",
        "type": "api_key"
    },
    "count": 9,
    "details": {
        "actionType": "DELETE",
        "message": "Resource successfully created",
        "patch": ""
    },
    "lastOccurredTimestamp": "2025-11-21 16:26:40.13921 +0000 UTC",
    "object": {
        "id": {
            "group": "argoproj.io",
            "kind": "Cluster",
            "name": "dev-team"
        },
        "parentId": {
            "applicationName": "web-app",
            "name": "",
            "parentName": ""
        },
        "type": "custom_role"
    },
    "timestamp": "2025-11-21 16:26:40.13921 +0000 UTC"
}