BMC Helix IT Operations Management (BHOM)

Connection Requirements

1 - Domain

The BMC Helix Portal host for your BMC Helix IT Operations Management (BHOM) tenant, without the scheme. For SaaS deployments enter the Product URL from your activation email (e.g. tenant.onbmc.com). For on-premises deployments enter the host and, if needed, the port (e.g. helix.example.com:8443).

2 - Access Key

The access key of a BMC Helix Portal API key pair. Generate one from BMC Helix Portal → Access Keys (or Administration → Repository). Octo exchanges the key pair for a short-lived JWT at /ims/api/v1/access_keys/login.

3 - Access Secret Key

The access secret key that pairs with the access key above. It is shown only once when the key pair is created, so store it securely.

4 - Proxy

Optional. An HTTP proxy in host:port format to route requests through, for environments where the BMC Helix Portal is only reachable via a corporate proxy. Leave blank if no proxy is required.

5 - Thread Count

The number of parallel workers used to enrich each monitored host with its metric entity context. (default: 32, max 32) Lower this if the BMC Helix Portal throttles concurrent requests.

6 - Sleep Time

Optional. A delay (in seconds) inserted between enrichment requests to ease load on the API. Leave blank for no delay.

7 - Timeout

The amount of time (in seconds) to wait for API responses. (default: 30)

Default Values

• Thread Count: 32

• Timeout: 30

Permissions Required

The API key pair must belong to a BMC Helix Portal user with at least the operator role, granting read access to the metric query service. Creating API keys requires the Administrator role. BHOM has no dedicated device-inventory endpoint: hosts are enumerated from the metric time-series database (/metrics-query-service/api/v1.0/label/hostname/values) and enriched per host via /metrics-query-service/api/v1.0/series.

Attention

BHOM is a monitoring platform, not an asset inventory. Discovered devices carry the hostname and entity context (device id, host type, source) but no IP, MAC, or OS details, since those are not exposed by the metric API. Please perform a connection test to ensure there is a valid connection to the BMC Helix Portal host.