Configure Alloy from the Configuration page

Use the Database Observability Configuration page to generate Alloy configuration from the Grafana Cloud UI.

Fleet Management is the recommended setup path for most teams. It lets you manage Alloy configuration centrally, apply configuration to registered collectors, and monitor collector health without manually editing Alloy configuration files.

For more information about Fleet Management, refer to Introduction to Fleet Management.

Before you begin

Before you use the Configuration page setup flow, complete the database-specific setup for your environment:

You also need:

Grafana Alloy installed and running in an environment that can connect to your database.
The Alloy collector enrolled in Grafana Fleet Management.
Network connectivity between the Alloy collector and your database.
Database credentials with the required monitoring permissions.

Choose a setup method

Database Observability supports two setup methods: Fleet Management and manual Alloy configuration.

The Setup tab table shows databases configured with Fleet Management. Manually configured databases don’t appear in this table, but you can still use the manual setup flow to generate Alloy configuration and deploy it with your own tools.

Fleet Management setup

Use Fleet Management setup when you want Grafana Cloud to help create and manage the Alloy configuration for Database Observability.

To start the Fleet Management setup flow:

Open Database Observability in Grafana Cloud.
Go to Configuration.
Open Setup.
Click Add database.
Select your database engine.
Select Fleet Management as the configuration method.
Follow the guided setup flow.

After setup, Fleet Management applies the generated configuration to the selected Alloy collector. You can use Fleet Management to view collector health, update configuration, and troubleshoot configuration issues from Grafana Cloud.

Manual setup

Use manual setup when you need to write or customize the Alloy configuration yourself.

Manual setup is useful when:

You can’t use Fleet Management in your environment.
You need custom Alloy components, labels, or relabeling rules.
You already manage Alloy configuration outside Grafana Cloud.
You’re troubleshooting an existing manual Alloy setup.

To configure Alloy manually, follow the database-specific setup guide for your environment:

Next steps

After you connect a database, use the Configuration page to:

Tune Alloy collection for collection intervals, query sampling, and data volume.
Monitor multiple databases when you add more database instances.
Verify telemetry status to confirm Database Observability is receiving data.