Skip to main content

Alertmanager Alerts

Oodle supports importing your existing Alertmanager alert rules and notification routes, making migration from Prometheus/Alertmanager seamless.

Import Methods​

There are two ways to import alerts from Alertmanager into Oodle:

  1. Upload YAML files - Upload your prometheus.yaml and alertmanager.yaml configuration files directly
  2. Scrape from Prometheus - Connect to your running Prometheus and Alertmanager instances to scrape alerts directly

Method 1: Import from YAML Files​

This method allows you to upload your Prometheus and Alertmanager configuration files directly to Oodle. This approach doesn't require network connectivity between Oodle and your Prometheus/Alertmanager instances.

Alertmanager File Upload

Steps​

  1. Login to the Oodle UI, then navigate to Settings page
  2. Click on the Alertmanager Alerts tile
  3. Select the Import Alerts from YAML files tab
  4. Upload your prometheus.yaml file containing your alert rules
  5. Upload your alertmanager.yaml file containing your notification routes
  6. The import will start automatically once both files are uploaded

What Gets Imported​

  • Alert Rules: All alert rules defined in your Prometheus configuration
  • Notification Routes: Routing rules from your Alertmanager configuration
  • Notification Policies: Receiver configurations mapped to Oodle notifiers

Method 2: Scrape Alerts from Prometheus​

This method connects directly to your Prometheus and Alertmanager instances to scrape the alert configurations. This requires network connectivity between the migration tool and your instances.

Alertmanager Scrape Import

Prerequisites​

  • Docker installed on your machine (Install Docker)
  • Network access to your Prometheus and Alertmanager instances

Steps​

  1. Login to the Oodle UI, then navigate to Settings page
  2. Search for Alertmanager Alerts and click Import
  3. Choose an appropriate API key from the dropdown at the top of the drawer
  4. Select the Scrape Alerts from Prometheus tab
  5. Enter your Prometheus URL (e.g., http://localhost:9090)
  6. Enter your Alertmanager URL (e.g., http://localhost:9091)
  7. Copy and run the generated Docker command

Docker Command​

The migration tool runs as a Docker container. After entering your Prometheus and Alertmanager URLs, a command will be generated:

docker run -it --pull=always --network host \
  public.ecr.aws/oodle-ai/oodle/migrator:latest prometheus \
  --prometheus-url http://host.docker.internal:9090 \
  --alertmanager-url http://host.docker.internal:9091 \
  --oodle-instance <INSTANCE_ID> \
  --oodle-api-key <API_KEY> \
  --oodle-endpoint <OODLE_ENDPOINT>
note

When using localhost URLs, they are automatically converted to host.docker.internal to ensure the Docker container can reach your local services.

Kubernetes Example​

If Prometheus and Alertmanager are running in a Kubernetes cluster, you can use port-forwarding to access them locally:

kubectl port-forward pods/<prometheus-pod-name> 9090 -n <prometheus-namespace>
kubectl port-forward pods/<alertmanager-pod-name> 9093 -n <alertmanager-namespace>

Then use http://localhost:9090 and http://localhost:9093 as the URLs for Prometheus and Alertmanager respectively.

Import Results​

After the import completes, you'll see a status indicating success or failure. The imported alerts will be available in the Alerts section of the Oodle UI.

Alertmanager Import Success

You can manage your imported alerts:

Other Migration Options​

Looking to migrate from other platforms? Check out these guides:

Support​

If you have any questions or need assistance, please contact us via our help chat app available on the Support link in the sidebar, or by reaching out to support@oodle.ai.