AlertManager Plugin for Steampipe

Use SQL to query infrastructure including alerts, receivers, silences and more from AlertManager.

• Get started →
• Documentation: Table definitions & examples
• Community: Join #steampipe on Slack →
• Get involved: Issues

Quick start

Install

Download and install the latest AlertManager plugin:

steampipe plugin install jplanckeel/alertmanager

Configure your credentials and config file.

Configure your account details in ~/.steampipe/config/alertmanager.spc:

connection "steampipe-plugin-alertmanager" {
  plugin  = "jplanckeel/alertmanager"

  # address to access the API (required).
  #address = "alertmanager.localhost.com:8080"
}

Run steampipe:

steampipe query

List teams in your AlertManager account:

select
  id,
  status,
  ends_at,
  created_by,a
  comment
from
  alertmanager_silences

+--------------------------------------+--------------------+--------------------------+------------+------------------------------------------------+
| id                                   | status             | ends_at                  | created_by | comment                                        |
+--------------------------------------+--------------------+--------------------------+------------+------------------------------------------------+
| 7bd63388-c0b6-475f-9dc3-0180d84dd8a2 | {"state":"active"} | 2033-05-29T17:08:23.298Z | jplanckeel |  silence alert ID34                            |
+--------------------------------------+--------------------+--------------------------+------------+------------------------------------------------+

Developing

Prerequisites:

• Steampipe
• Golang

Clone:

git clone https://github.com/jplanckeel/steampipe-plugin-alertmanager.git
cd steampipe-plugin-alertmanager

Build, which automatically installs the new version to your ~/.steampipe/plugins directory:

make

Configure the plugin:

cp config/* ~/.steampipe/config
vi ~/.steampipe/config/alertmanager.spc

Try it!

steampipe query
> .inspect alertmanager

Further reading:

• Writing plugins
• Writing your first table

Contributing

Please see the contribution guidelines and our code of conduct. All contributions are subject to the Apache 2.0 open source license.

help wanted issues:

• Steampipe
• AlertManager Plugin