Add health events to Postgres (DataDog#21193)

* Add Postgres Health class for tracking Postgres health events

* Changelog

* Fix changelog number

Author: sethsamuel

postgres/changelog.d/21193.added

@@ -0,0 +1 @@
+Add Postgres Health class for submitting Postgres health events

postgres/datadog_checks/postgres/health.py

@@ -0,0 +1,58 @@
+# (C) Datadog, Inc. 2025-present
+# All rights reserved
+# Licensed under a 3-clause BSD style license (see LICENSE)
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from datadog_checks.postgres import PostgreSql
+
+from enum import Enum
+
+from datadog_checks.base.utils.db.health import Health, HealthEvent, HealthStatus
+
+
+class PostgresHealthEvent(Enum):
+    """
+    Enum representing the health events for PostgreSQL monitoring.
+    """
+
+    EXPLAIN_PLAN_ERROR = 'explain_plan_error'
+
+
+class PostgresHealth(Health):
+    def __init__(self, check: PostgreSql):
+        # type: (PostgreSql) -> None
+        """
+        Initialize the PostgresHealth instance.
+
+        :param check: PostgreSql
+            The check instance that will be used to submit health events.
+        """
+        super().__init__(check)
+        self.check = check
+
+    def submit_health_event(
+        self,
+        name: HealthEvent | PostgresHealthEvent,
+        status: HealthStatus,
+        **kwargs,
+    ):
+        """
+        Submit a health event to the aggregator.
+
+        :param name: PostgresHealthEvent
+            The name of the health event.
+        :param status: HealthStatus
+            The health status to submit.
+        :param kwargs: Additional keyword arguments to include in the event.
+        """
+        super().submit_health_event(
+            name,
+            status,
+            # If we have an error parsing the config we may not have tags yet
+            self.check.tags if hasattr(self.check, 'tags') else [],
+            database_identifier=self.check.database_identifier,
+            **kwargs,
+        )

postgres/datadog_checks/postgres/postgres.py

@@ -23,6 +23,7 @@
 from datadog_checks.postgres import aws, azure
 from datadog_checks.postgres.connection_pool import LRUConnectionPoolManager, PostgresConnectionArgs
 from datadog_checks.postgres.discovery import PostgresAutodiscovery
+from datadog_checks.postgres.health import PostgresHealth
 from datadog_checks.postgres.metadata import PostgresMetadata
 from datadog_checks.postgres.metrics_cache import PostgresMetricsCache
 from datadog_checks.postgres.relationsmanager import (
@@ -102,6 +103,7 @@ class PostgreSql(AgentCheck):
 
     def __init__(self, name, init_config, instances):
         super(PostgreSql, self).__init__(name, init_config, instances)
+        self.health = PostgresHealth(self)
         self._resolved_hostname = None
         self._database_identifier = None
         self._agent_hostname = None
@@ -125,10 +127,12 @@ def __init__(self, name, init_config, instances):
                 "DEPRECATION NOTICE: The managed_identity option is deprecated and will be removed in a future version."
                 " Please use the new azure.managed_authentication option instead."
             )
+
         self._config = PostgresConfig(self.instance, self.init_config, self)
         self.cloud_metadata = self._config.cloud_metadata
         self.tags = self._config.tags
         self.add_core_tags()
+
         # Keep a copy of the tags without the internal resource tags so they can be used for paths that don't
         # go through the agent internal metrics submission processing those tags
         self._non_internal_tags = copy.deepcopy(self.tags)