Notifications

Notifications are a way to keep track of important events on the Akuity Platform. You can receive notifications for a variety of events, such as usage alerts of applications, audit logs, and more. Notifications can be sent using 3 different methods: email, webhook, and Akuity Platform UI.

Notification Center

The Notification Center is where you can view all the notifications that have been sent to you through Akuity Platform UI. You can access the Notification Center by clicking on the bell icon (🔔) in the top right corner of the Akuity Platform and then clicking on Notifications Center. The Notification Center will display all the notifications that have been sent to you, and you can view the details of each notification by clicking on it.

Settings

You can manage your notification settings by going to the Settings tab in the Notification Center page. You can enable or disable notifications for each event type. You can also choose the method of notification for each event type. You can choose to receive notifications via email, or the Akuity Platform UI.

The different categories of notifications are:

• Billing - Notifications related to billing events, such as subscription renewals, payment failures, etc.
• Marketing - Notifications related to marketing events, such as new features, promotions, etc.
• Product Updates - Notifications related to product updates, such as new releases, bug fixes, etc.
• Usage Alerts - Notifications related to usage alerts, such as reaching usage limits, etc.

Email Notifications

Email notifications are sent to the email address associated with your account. An email notification is sent when an event occurs that you have subscribed to. You can manage your email notifications by going to the Settings tab in the Notification Center page. You can enable or disable email notifications for each event type.

An example of an email notification for Usage Alerts is shown below:

Akuity Platform UI Notifications (Web Notifications)

Akuity Platform UI notifications are notifications that are displayed in the Akuity Platform UI. These notifications are displayed in the top right corner of the Akuity Platform, and you can view them by clicking on the bell icon (🔔). Akuity Platform UI notifications are sent when an event occurs that you have subscribed to. You can manage your Akuity Platform UI notifications by going to the Settings tab in the Notification Center page. You can enable or disable Akuity Platform UI notifications for each event type.

An example of an Akuity Platform UI notification for Usage Alerts is shown below:

Organization Notifications

Organization notifications allow you to receive alerts for events happening within your organization. These can be configured to be sent via Webhook or Email.

Webhook Notifications

Webhook notifications are sent to a URL that you specify.

When a webhook notification is sent, the Akuity Platform will send a POST request to the specified URL with the notification details in the request body. The request body will contain a JSON object with the following fields:

• eventTime - The time at which the event occurred.
• eventType - The type of event that occurred.
• organizationId - The ID of the organization to which the event is related.
• eventId - The ID of the event.
• <eventTypeData> - Additional data related to the eventType.

To set up an organization notification, follow these steps:

1. Select the Organization you want to create a notification for, from the pull down menu.
2. Click on the Settings button.
3. Switch to the Notifications tab.
4. Click the + Add New button.
5. Fill notification details in the dialog.

• Type: Select Webhook.
• Name: Name of the webhook.
• URL: URL of the webhook.
• Secret: Secret for validate webhook payload signature.
• Events: Event types to subscribe (* for all events).
• Argo CD Instances: If set, webhook will receive events that only related to the chosen Argo CD instances.
• Kargo Instances: If set, webhook will receive events that only related to the chosen Kargo instances.
• Argo CD Clusters: Only applicable for agent-health events. If set, webhook will receive events that only related to the chosen Argo CD clusters.
• Kargo Agents: Only applicable for agent-health events. If set, webhook will receive events that only related to the chosen Kargo agents.

note

The filter fields above support regular expressions. The value is wrapped in ^...$. For example, test.* matches all names starting with test.

6. Click the Add button.
7. The notification will be added to the list. To view the delivery history, click on the View button.

8. Click on the Send testing event button to send a test event.

9. The webhook will be sent a test ping event and the response will be displayed. If you see a tick mark, the webhook was successfully sent. You can click on the + icon to view the response.

An example of a webhook notification for audit event is shown below:

{
  "eventTime": "2024-08-23T13:21:30.647737Z",
  "eventType": "WEBHOOK_EVENT_TYPE_AUDIT",
  "organizationId": "yswhibye4b9xy0e",
  "eventId": "c2txb45sbae7m5m9",
  "auditEvent": {
    "timestamp": "2024-08-23 13:21:30.622450296 +0000 UTC",
    "action": "created",
    "actor": {
      "type": "akuity_user_email",
      "id": "user@example.com"
    },
    "object": {
      "type": "custom_role",
      "id": {
        "name": "test",
        "kind": "",
        "group": ""
      },
      "parentId": {
        "name": "",
        "parentName": "",
        "applicationName": ""
      }
    },
    "details": {
      "message": "",
      "patch": "",
      "actionType": ""
    }
  }
}

Webhook Notification Types

The following are the different types of webhook events that you can subscribe to:

1. audit - Audit log events.
2. usage - Usage alert events.
3. agent-health - Agent health events (connected/disconnected).
4. * - All events.

For more information on the webhook schema, refer to the Notification Webhook Schema.

Email Notifications

Email notifications are sent to the email addresses that you specify.

To set up an email notification, follow these steps:

1. Select the Organization you want to create a notification for, from the pull down menu.
2. Click on the Settings button.
3. Switch to the Notifications tab.
4. Click the + Add New button.
5. Fill notification details in the dialog.

• Type: Select Email.
• Name: Name of the notification configuration.
• Emails: List of email addresses to send notifications to.
• Events: Event types to subscribe. Currently supported events are:
  • agent-health - Agent health events (connected/disconnected).
  • usage - Usage alert events.
• Argo CD Instances: If set, emails will be sent for events that only related to the chosen Argo CD instances.
• Kargo Instances: If set, emails will be sent for events that only related to the chosen Kargo instances.
• Argo CD Clusters: Only applicable for agent-health events. If set, emails will be sent for events that only related to the chosen Argo CD clusters.
• Kargo Agents: Only applicable for agent-health events. If set, emails will be sent for events that only related to the chosen Kargo agents.

note

The filter fields above support regular expressions. The value is wrapped in ^...$. For example, test.* matches all names starting with test.

6. Click the Add button.