Groups

Groups allow you to categorize events within a zone, enabling more organized event tracking and customized notification settings.

What are Groups?

Groups are subsets of events within a zone that share a common purpose or category. For example, you might create groups for:

• Different services in your infrastructure (database, API, web server)
• Different types of events (errors, metrics, deployments)
• Different environments (production, staging, development)

Accessing Groups

You can access group management through:

1. Zone Settings > Groups
2. Using the group filters in the zone event view

Creating a Group

To create a new group:

1. Navigate to Zone Settings > Groups
2. Click “Create new group”
3. Enter a name for your group (e.g., “Database”)
4. The system will automatically generate an alias based on your group name, or you can customize it
5. Click “Create” to finalize

Note

Group aliases should be lowercase, and can only contain letters, numbers, underscores, and hyphens.

Group Settings

Each group can have its own settings that override zone-level defaults:

Notification Settings

Control how and when push notifications are sent for events in this group:

• Push Notifications Enabled - When turned on, all events in this group trigger notifications
• Push Notifications for Errors Only - When turned on, only events with error codes in this group trigger notifications

Tip

Group notification settings override zone-level settings. This allows you to create groups for critical events that always trigger notifications, and other groups that never do.

Notification Icon

Each group can have its own unique icon and color:

1. Select an icon from the available options
2. Choose a color for the icon

This icon will be displayed in the events list and in push notifications, making it easy to visually identify which group an event belongs to.

Using Groups in API Calls

When sending events to Notifery via the API, you can specify a group by including the group parameter with your group’s alias:

fetch('https://api.notifery.com/event', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'x-api-key': 'YOUR_API_KEY'
  },
  body: JSON.stringify({
    title: 'Database Backup Complete',
    message: 'Successfully backed up 1.2GB of data',
    zone: 'production',
    group: 'database'  // Specify the group alias here
  })
})

Group Limitations

Your plan determines the maximum number of groups you can create:

1. Navigate to Zone Settings > Plan to view your group limit
2. The Groups page will display how many groups you have used out of your maximum allowance

Caution

Once you reach your group limit, you’ll need to remove existing groups or upgrade your plan to create more.

Filtering by Groups

In the zone’s event view, you can filter events by group:

1. Click on a group name in the filter bar
2. The event list will update to show only events from that group
3. You can select multiple groups to view events from any of those groups
4. Badge counts on groups show the number of unread events in each group

This filtering capability makes it easy to focus on events from specific areas of your application or system.