SAP HANA

The SAP HANA source collects logs from an SAP HANA database. It reads the database's trace and diagnostic files from the collector host's filesystem, optionally parses each record into structured fields, and forwards them through your pipeline. Collection is file-based: the collector tails the configured trace file paths. No connection to the database is required.

Supported Telemetry Types

Platform	Metrics	Logs	Traces
Linux		✓
Windows		✓
macOS		✓

Prerequisites

• An SAP HANA database that is writing trace and diagnostic files to disk. By default these are written to /usr/sap/<SID>/HDB<instance>/<host>/trace/ on the database host. See Diagnostic Files and Logs in the SAP HANA Platform documentation. Configuring or enabling individual traces requires the TRACE ADMIN system privilege.
• A collector installed on the SAP HANA host (or a host with access to the trace files) with read permission on the configured log path(s). The trace directory and its files are typically owned by the <sid>adm operating-system user, so run the collector as a user that can read them.
• The trace file path(s) for your instance. The default /usr/sap/*/HDB*/*/trace/*.trc glob matches a standard single-tenant layout. Tenant databases write to a DB_<database_name> subdirectory, so adjust the path for multitenant systems.

Configuration

Logs

Parameter	Type	Required	Default	Description
Log Path(s)	Strings	Yes	/usr/sap/*/HDB*/*/trace/*.trc	File paths to logs. Supports glob patterns. Add one or more paths to match the trace files for your instance.

Advanced

Parameter	Type	Required	Default	Description
Timezone	Timezone	No	UTC	The timezone to use when parsing timestamps.
Start At	Enum: beginning, end	No	end	Start reading logs from the beginning or end of each file. Use beginning to ingest existing content on first run.
Parse	Boolean	No	true	Parses the log fields into structured data. When disabled, records are forwarded as raw lines.

Examples

Collect trace logs from a single-tenant instance

Read the default trace files, parse them into structured fields, and only ingest new entries written after the collector starts.

apiVersion: bindplane.observiq.com/v1
kind: Source
metadata:
  name: sap-hana
spec:
  type: hana
  parameters:
    - name: file_path
      value:
        - /usr/sap/*/HDB*/*/trace/*.trc
    - name: start_at
      value: end
    - name: timezone
      value: UTC
    - name: parse
      value: true

Backfill existing logs from a tenant database

Point at a tenant database's trace subdirectory and read existing content from the beginning of each file.

apiVersion: bindplane.observiq.com/v1
kind: Source
metadata:
  name: sap-hana
spec:
  type: hana
  parameters:
    - name: file_path
      value:
        - /usr/sap/PRD/HDB00/host01/trace/DB_TENANT1/*.trc
    - name: start_at
      value: beginning
    - name: parse
      value: true

Configuration Tips

• The default path glob targets a standard single-tenant layout. For multitenant systems, add a path that includes the DB_<database_name> subdirectory for each tenant you want to collect.
• Leave Start At on end for steady-state collection to avoid re-ingesting historical files. Set it to beginning only for an initial backfill, then revert.
• Set Timezone to match the timezone the database host writes into its trace timestamps so parsed timestamps are accurate.

Troubleshooting

No logs are collected

Symptoms: the source is configured but no log records flow.

Solutions:

1. Confirm the configured path(s) match real .trc files on the collector host. Verify the glob resolves to actual files for your SID, instance, and host.
2. Confirm the collector's operating-system user has read permission on the trace directory and files. They are typically owned by <sid>adm.
3. If you expect existing content, set Start At to beginning. With end, only new lines written after the collector starts are read.

Timestamps are off by hours

Symptoms: parsed log timestamps are shifted from the actual event time.

Solutions:

1. Set Timezone to the timezone the SAP HANA host uses when writing trace timestamps.
2. Confirm Parse is enabled. With Parse disabled, records are forwarded as raw lines and timestamps are not extracted.

Standalone Source

apiVersion: bindplane.observiq.com/v1
kind: Source
metadata:
  name: sap-hana
spec:
  type: hana
  parameters:
    - name: file_path
      value:
        - /usr/sap/*/HDB*/*/trace/*.trc
    - name: timezone
      value: UTC
    - name: start_at
      value: end
    - name: parse
      value: true

Related Resources

• SAP HANA Platform: Diagnostic Files and Logs
• OpenTelemetry filelog receiver