[smartagent/hana] deprecate hana monitor in favor of saphana and sqlquery receivers (#7261)

Author: atoulme

.chloggen/deprecate_hana.yaml

@@ -0,0 +1,19 @@
+# One of 'breaking', 'deprecation', 'new_component', 'enhancement', 'bug_fix'
+change_type: deprecation
+
+# The name of the component, or a single word describing the area of concern, (e.g. crosslink)
+component: hana
+
+# A brief description of the change.  Surround your text with quotes ("") if it needs to start with a backtick (`).
+note: Deprecate the hana monitor
+
+# One or more tracking issues related to the change
+issues: [7261]
+
+# (Optional) One or more lines of additional information to render under the primary note.
+# These lines will be padded with 2 spaces and then inserted directly into the document.
+# Use pipe (|) for multiline entries.
+subtext: |
+  The hana monitor is deprecated and will removed on or after May 2026. Please use the 
+  [saphana](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/main/receiver/saphanareceiver) 
+  and [sqlquery](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/main/receiver/sqlqueryreceiver) receivers instead.

internal/signalfx-agent/pkg/monitors/hana/metadata.yaml

@@ -1,6 +1,8 @@
 monitors:
   - monitorType: hana
     doc: |
+      **The HANA monitor is deprecated and will be removed on or after May 2026.
+      Please use the sqlquery receiver and the saphana receiver instead.**
       This monitor sends SQL queries to an SAP Hana database, emitting the results as metrics.
 
       ```yaml

internal/signalfx-agent/pkg/monitors/hana/monitor.go

@@ -102,7 +102,7 @@ func configureSQLMonitor(output types.Output, monCfg config.MonitorConfig, connS
 		DBDriver:         "hdb",
 		Queries:          queries(maxExpensiveQueries),
 		LogQueries:       logQueries,
-	})
+	}, "[NOTICE] The hana monitor is deprecated and will removed on or after May 2026. Please use the saphana and sqlquery receivers instead.")
 }
 
 func (m *Monitor) Shutdown() {

internal/signalfx-agent/pkg/monitors/sql/monitor.go

@@ -152,9 +152,12 @@ type Monitor struct {
 }
 
 // Configure the monitor and kick off metric gathering
-func (m *Monitor) Configure(conf *Config) error {
+func (m *Monitor) Configure(conf *Config, deprecationWarning ...string) error {
 	m.logger = logrus.WithField("monitorType", conf.Type).WithField("monitorID", conf.MonitorID)
 	m.ctx, m.cancel = context.WithCancel(context.Background())
+	for _, warning := range deprecationWarning {
+		m.logger.Warn(warning)
+	}
 
 	// This will "open" a database by verifying that the config is sane but
 	// generally won't try and connect to it.  If it does attempt to connect