Chapter 6. Enabling alert routing for user-defined projects

Procedure

1. Edit the

   cluster-monitoring-config

   ConfigMap

   object:

   $ oc -n openshift-monitoring edit configmap cluster-monitoring-config

2. Add

   enableUserAlertmanagerConfig: true

   in the

   alertmanagerMain

   section under

   data/config.yaml

   :

   apiVersion: v1
   kind: ConfigMap
   metadata:
     name: cluster-monitoring-config
     namespace: openshift-monitoring
   data:
     config.yaml: |
       # ...
       alertmanagerMain:
         enableUserAlertmanagerConfig: true 

   1

   
       # ...

   1

   Set the enableUserAlertmanagerConfig value to true to allow users to create user-defined alert routing configurations that use the main platform instance of Alertmanager.

3. Save the file to apply the changes. The new configuration is applied automatically.

Procedure

1. Edit the

   user-workload-monitoring-config

   ConfigMap

   object:

   $ oc -n openshift-user-workload-monitoring edit configmap user-workload-monitoring-config

2. Add

   enabled: true

   and

   enableAlertmanagerConfig: true

   in the

   alertmanager

   section under

   data/config.yaml

   :

   apiVersion: v1
   kind: ConfigMap
   metadata:
     name: user-workload-monitoring-config
     namespace: openshift-user-workload-monitoring
   data:
     config.yaml: |
       alertmanager:
         enabled: true 

   1

   
         enableAlertmanagerConfig: true 

   2

   1

   Set the enabled value to true to enable a dedicated instance of the Alertmanager for user-defined projects in a cluster. Set the value to false or omit the key entirely to disable the Alertmanager for user-defined projects. If you set this value to false or if the key is omitted, user-defined alerts are routed to the default platform Alertmanager instance.

   2

   Set the enableAlertmanagerConfig value to true to enable users to define their own alert routing configurations with AlertmanagerConfig objects.

3. Save the file to apply the changes. The dedicated instance of Alertmanager for user-defined projects starts automatically.