​

Creating and Managing Alerts in Metoro

Metoro provides two methods for creating and managing alerts:

1. Using the Metoro UI
2. Using Kubernetes ConfigMaps

​

Managing Alerts Using the UI

To create a new alert using the Metoro UI:

1. Navigate to the Alerts page
2. Click on the Create Alert button
3. Configure your alert conditions. For more information about alert configuration, please check the API documentation.

You can update existing alerts by clicking on the alert name in the list. This will take you to the alert details page. You can click Edit to modify alert configuration.

​

Managing Alerts Using Kubernetes ConfigMaps

For organizations that prefer Infrastructure as Code (IaC) practices, Metoro supports creating and managing alerts using Kubernetes ConfigMaps.

​

ConfigMap Requirements

1. ConfigMaps must include the label metoro.io/alert: "true" to be recognized by Metoro as an alert definition.
   • ConfigMaps without this label will be ignored by Metoro.
2. The ConfigMap data must include a key named alert.yaml with alerts and the toplevel key containing the alert definition(s).
3. The alert definition must follow the format specified in the API documentation.

​

Alert Synchronization

• Alerts defined in ConfigMaps are automatically synced with Metoro once every hour.
• Alerts managed via ConfigMaps cannot be edited through the UI to prevent conflicts.
• Any changes made via the API would be overwritten during the next sync cycle.
• If you delete a ConfigMap, the corresponding alert will not be deleted in Metoro. This is to prevent cluster outages deleting alerts etc. After removing the configmap you should subsequently delete the alert in the UI. Subsequent syncs will not recreate the alert.

​

Manual Synchronization

If you don’t want to wait for the hourly sync, you can:

• Use the “Sync Alerts” button on the Alerts page in the Metoro UI
• Call the endpoint GET "/api/v1/alerts/sync" with your auth token. For more information, please check the API documentation.

​

Example ConfigMap

Please check the API documentation for the full alert definition format. Below is a simple example of a ConfigMap that defines an alert:

kind: ConfigMap
apiVersion: v1
metadata:
  name: alert-config
  labels:
    metoro.io/alert: "true"
data:
  alert.yaml: |
   alerts:
   - metadata:
       id: "trace-count-alert-001"
       name: "Trace Count Upper Bound"
       description: "Alert when there are too many traces"
     type: timeseries
     timeseries:
       expression:
         metoroQLTimeseries:
           query: "count(traces)"
           bucketSize: 60
       evaluationRules:
         - name: critical
           type: static
           static:
             operators:
               - operator: greaterThan
                 threshold: 15
             persistenceSettings:
               datapointsToAlarm: 3
               datapointsInEvaluationWindow: 5
               missingDatapointBehavior: notBreaching

For more examples, please check the Example Alerts section.

​

Troubleshooting ConfigMap Alert Synchronization

If you don’t see your alerts being created or updated from ConfigMaps, the issue is most likely due to one of the following reasons:

1. Ingestion Delay: Allow at least one full minute for your new ConfigMap definition to be ingested by Metoro. After this period, try to sync alerts manually either via the UI or the API.

2. Missing or Incorrect Labels: Double-check that your ConfigMap has the necessary label metoro.io/alert: "true" as described in the ConfigMap Requirements section.