> For the complete documentation index, see [llms.txt](https://docs.bindplane.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.bindplane.com/integrations/sources/sap-netweaver.md).

# SAP NetWeaver

The SAP NetWeaver source collects metrics from an SAP NetWeaver instance by calling the SAPControl web service exposed by the SAP Start Service (`sapstartsrv`). Bindplane connects to the instance over HTTP or HTTPS using OS-user basic authentication and scrapes availability, work process, CPU, memory, session, request, queue, lock, connection, cache, and short-dump metrics on a fixed interval.

### Supported Telemetry

| Platform | Metrics | Logs | Traces |
| -------- | ------- | ---- | ------ |
| Linux    | ✓       |      |        |

### Prerequisites

Supports SAP NetWeaver 7.10 and later.

The collector must run on the SAP NetWeaver host. Some metrics (certificate validity, and the optional RFC and session-count metrics) require executing OS-level commands locally, so a remote collector cannot gather them.

Connecting requires a valid OS user and password. SAP NetWeaver authenticates the SAPControl web service with the host operating system user via HTTP basic auth, and the user needs read access to the SAP instance. For SAP NetWeaver 7.38 and later, collecting some metrics also requires execute or write permission for the `sapstartsrv` instance.

The SAP Start Service exposes SAPControl over HTTP port 50013 and HTTPS port 50014 for instance number 00. Adjust the port for your instance number. See the [SAP Start Service documentation](https://help.sap.com/docs/SAP_NETWEAVER_750/5b4066fc1d584f14b84df07d8ba99c78/b3903925c34a45e28a2861b59c3c5623.html) for details on the SAPControl interface and ports.

### Configuration

<figure><img src="/files/EAVGASEB6IMMffPUgFQI" alt="Bindplane docs - SAP NetWeaver - image 1"><figcaption></figcaption></figure>

**Connection**

| Parameter | Type   | Required | Default     | Description                                                                                                              |
| --------- | ------ | -------- | ----------- | ------------------------------------------------------------------------------------------------------------------------ |
| Hostname  | string | Yes      | `localhost` | The hostname or IP address of the SAP NetWeaver system.                                                                  |
| Port      | int    | No       | `50013`     | The TCP port of the SAP NetWeaver system. Use `50013` for HTTP and `50014` for HTTPS, adjusted for your instance number. |
| Username  | string | Yes      | *(empty)*   | The username to use when connecting to SAP NetWeaver.                                                                    |
| Password  | string | Yes      | *(empty)*   | The password to use when connecting to SAP NetWeaver. Stored as a sensitive value.                                       |

**Advanced**

| Parameter           | Type    | Required | Default   | Description                                                                                                                                                                                                                                                                                |
| ------------------- | ------- | -------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Collection Interval | int     | No       | `60`      | How often (seconds) to scrape for metrics.                                                                                                                                                                                                                                                 |
| Profile             | string  | No       | *(empty)* | The profile path in the form `/sapmnt/SID/profile/SID_INSTANCE_HOSTNAME`, used to collect the optional RFC and session-count metrics. See [SAP profile documentation](https://help.sap.com/docs/SAP_NETWEAVER_750/b17bd20044a44edb9aa7830ee52ffac3/00fabccaa98348f291f3c7f02098116b.html). |
| Metrics             | metrics | No       | *(empty)* | Toggle individual metrics on and off. By default all metrics are enabled; listing a metric here disables it.                                                                                                                                                                               |

**TLS**

| Parameter                         | Type   | Required | Default   | Description                                                                                                          |
| --------------------------------- | ------ | -------- | --------- | -------------------------------------------------------------------------------------------------------------------- |
| Enable TLS                        | bool   | No       | `false`   | Whether or not to use TLS. Enable when connecting over HTTPS (typically port 50014).                                 |
| Skip TLS Certificate Verification | bool   | No       | `false`   | Skip TLS certificate verification. Only relevant when Enable TLS is `true`.                                          |
| TLS Certificate Authority File    | string | No       | *(empty)* | Certificate authority used to validate TLS certificates. Only relevant when Enable TLS is `true`.                    |
| TLS Client Certificate File       | string | No       | *(empty)* | A TLS certificate used for client authentication, if mutual TLS is enabled. Only relevant when Enable TLS is `true`. |
| TLS Client Private Key File       | string | No       | *(empty)* | A TLS private key used for client authentication, if mutual TLS is enabled. Only relevant when Enable TLS is `true`. |

### Examples

#### Collect metrics over HTTP from a local instance

This example scrapes the SAPControl web service on the default HTTP port of a local SAP NetWeaver instance every 60 seconds.

```yaml
apiVersion: bindplane.observiq.com/v1
kind: Source
metadata:
  name: sap-netweaver
spec:
  type: netweaver
  parameters:
    - name: hostname
      value: localhost
    - name: port
      value: 50013
    - name: username
      value: sapadm
    - name: password
      value: ${SAP_PASSWORD}
    - name: collection_interval
      value: 60
```

#### Collect metrics over HTTPS with the profile path

This example connects over HTTPS on port 50014 and sets the profile path so the optional RFC and session-count metrics are collected.

```yaml
apiVersion: bindplane.observiq.com/v1
kind: Source
metadata:
  name: sap-netweaver
spec:
  type: netweaver
  parameters:
    - name: hostname
      value: sap.example.com
    - name: port
      value: 50014
    - name: username
      value: sapadm
    - name: password
      value: ${SAP_PASSWORD}
    - name: profile
      value: /sapmnt/S4H/profile/S4H_D00_sap
    - name: enable_tls
      value: true
    - name: ca_file
      value: /etc/otel/certs/sap-ca.crt
```

### Configuration Tips

* Match the port to the protocol: use `50013` with TLS disabled for HTTP, and `50014` with TLS enabled for HTTPS, adjusting for your instance number.
* Certificate validity, RFC, and session-count metrics are only available when the collector runs on the SAP NetWeaver host. Set the Profile path to enable the RFC and session-count metrics.
* Use the Metrics toggle to disable metrics you do not need rather than collecting the full default set.

### Troubleshooting

#### Authentication failures

Symptoms: the source produces no metrics and the collector logs report authorization or 401 errors from the SAPControl endpoint.

Solutions:

1. Confirm the Username and Password belong to a valid OS user on the SAP NetWeaver host with read access to the instance.
2. For SAP NetWeaver 7.38 and later, confirm the user has execute or write permission for the `sapstartsrv` instance.

#### Connection refused or wrong port

Symptoms: the collector cannot reach the endpoint, or TLS handshake errors appear.

Solutions:

1. Verify the Port matches your instance number and protocol (`50013` for HTTP, `50014` for HTTPS at instance 00).
2. If connecting over HTTPS, set Enable TLS to `true`. For self-signed certificates, supply the CA file or temporarily enable Skip TLS Certificate Verification.

#### Missing RFC, session-count, or certificate metrics

Symptoms: most metrics appear but the RFC, session-count, or certificate-validity metrics are absent.

Solutions:

1. Confirm the collector runs directly on the SAP NetWeaver host, since these metrics require local OS command execution.
2. Set the Profile path to the instance profile so the optional RFC and session-count metrics are collected.

### Standalone Source

```yaml
apiVersion: bindplane.observiq.com/v1
kind: Source
metadata:
  name: sap-netweaver
spec:
  type: netweaver
  parameters:
    - name: hostname
      value: sap.example.com
    - name: port
      value: 50013
    - name: username
      value: sapadm
    - name: password
      value: ${SAP_PASSWORD}
    - name: collection_interval
      value: 60
    - name: enable_tls
      value: false
```

### Related Resources

* [SAP NetWeaver Receiver (Bindplane OpenTelemetry Collector)](https://github.com/observIQ/bindplane-otel-collector/tree/main/receiver/sapnetweaverreceiver)
* [SAP Start Service and SAPControl web service](https://help.sap.com/docs/SAP_NETWEAVER_750/5b4066fc1d584f14b84df07d8ba99c78/b3903925c34a45e28a2861b59c3c5623.html)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.bindplane.com/integrations/sources/sap-netweaver.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.