Skip to content

Latest commit

 

History

History
89 lines (77 loc) · 5.19 KB

README.md

File metadata and controls

89 lines (77 loc) · 5.19 KB

SAP Netweaver Receiver

This receiver collects metrics from SAP Netweaver instance based on the SAPControl Web Service Interface. Stats are collected from the GetAlertTree and EnqGetLockTable methods.

Supported Pipelines

  • Metrics

How It Works

  1. The user configures this receiver in a pipeline.
  2. The user configures a supported component to route telemetry from this receiver.

Prerequisites

  • SAP Netweaver 7.10+
  • The ability to authenticate to the OS
  • SAP read-only permission
  • For SAP version 7.38+, (Windows: execute permission, Unix: write permission) is required for each instance of sapstartsrv on the host. If this permission is being assigned to a group, the - monitoring user in the group must have the group set as primary. If authentication or authorization check fails the request will fail with “Invalid Credentials" or "Permission denied" fault string.
  • The receiver must run on host to execute OS executables in order to collect sapnetweaver.certificate.validity, sapnetweaver.abap.rfc.count and sapnetweaver.abap.session.count metrics.

More information on how to setup a SAP NetWeaver Stack for each operating system and version can be found here.

Configuration

Field Type Default Description
metrics map (default: see DefaultMetricsSettings here) Allows enabling and disabling specific metrics from being collected in this receiver.
endpoint string http://localhost:50013 The name of the metric created.
username string (no default) Specifies the username used to authenticate using basic auth.
password string (no default) Specifies the password used to authenticate using basic auth.
profile string (no default) Specifies the profile path in the form of /sapmnt/SID/profile/SID_INSTANCE_HOSTNAME to collect sapnetweaver.abap.rfc.count and sapnetweaver.abap.session.count metrics.
collection_interval duration 60s This receiver collects metrics on an interval. This value must be a string readable by Golang's time.ParseDuration.

Example Configuration

receivers:
  sapnetweaver:
    metrics:
    endpoint: http://localhost:50013
    username: root
    password: password
    collection_interval: 60s
processors:
  batch:
exporters:
  googlecloud:
    project: my-gcp-project

service:
  pipelines:
    metrics:
      receivers: [sapnetweaver]
      processors: [batch]
      exporters: [googlecloud]

Example Configuration With TLS

receivers:
  sapnetweaver:
    metrics:
    endpoint: https://sapnetweaver.example.com:50014
    username: root
    password: password
    collection_interval: 60s
    tls:
      ca_file: "certs/ca.crt"
      key_file: "certs/server.key"
      cert_file: "certs/server.crt"
processors:
  batch:
exporters:
  googlecloud:
    project: my-gcp-project

service:
  pipelines:
    metrics:
      receivers: [sapnetweaver]
      processors: [batch]
      exporters: [googlecloud]

The full list of settings exposed for this receiver are documented here with detailed sample configurations here.

Metrics

The following metrics are available with ICM version 7.81+:

  • sapnetweaver.job.aborted: GetAlertTree name = AbortedJobs
  • sapnetweaver.request.count: GetAlertTree name = StatNoOfRequests
  • sapnetweaver.request.timeout.count: GetAlertTree name = StatNoOfTimeouts
  • sapnetweaver.connection.error.count: GetAlertTree name = StatNoOfConnectErrors

Details about the metrics produced by this receiver can be found in metadata.yaml