Usage reporting

The Agent can provide valuable usage data, helping EDB understand how customers are using our products and facilitating core-based licensing and entitlements. This functionality is available regardless of whether you're using Hybrid Manager (HM) for monitoring or are running an on-premises database server.

Usage reporting with the Agent is an opt-in service. Data is only sent to EDB when you explicitly enable it. When enabled, the agent sends a new report every 12 hours by default, starting with the first time the agent runs.

What type of data is collected?

When configured to send usage data, the Agent generates a small report containing environment metadata and resource usage. This includes information like:

• Operating system details
• Memory and CPU usage
• Installed database distribution (e.g., PostgreSQL, EDB Postgres Advanced Server, EDB Postgres Extended Server) and version

Where is the data sent to?

When configured, reporting data goes to https://pg-usage.enterprisedb.com, an EDB-managed S3 bucket.

How do I enable usage reporting with the Agent?

If you are using the Hybrid Manager for centralized observability and monitoring, you can enable reporting as part of your Agent's configuration. See Enabling usage reporting in HM.

If you have a standalone deployment of a database server (PostgreSQL, EPAS, PGE), and you don't wish to use the Hybrid Manager, see Enabling usage reporting for standalone databases.

How many Agents do I need to track several databases?

Regardless of your setup, EDB recommends deploying one Agent per host machine with self-managed database clusters. While a single Agent can track databases across different hosts, keeping the Agent on the same machine is necessary to capture full host-level metrics.

To enable tracking and observability, you only need to provide the Agent access to one database per database server instance (via a DSN string). The Agent will automatically discover the other databases on that instance.