MosaicOA PE Receiver

The MosaicOA PE Receiver monitors a MosaicOA PE status endpoint and emits OpenTelemetry metrics. It can optionally add gateway information obtained from InfluxDB v2.

Capabilities

• Polls the MosaicOA PE status endpoint.
• Reports topic records and polls.
• Reports xPath, update, Dataview, CIMP, garbage-collection, and memory information.
• Preserves release and status context as OpenTelemetry resource attributes.
• Optionally reports comma-containing InfluxDB column-tag values for configured gateways.
• Supports HTTPS, private certificate authorities, and mutual TLS.

Prerequisites

• Network access to the MosaicOA PE status endpoint.
• TLS trust material when HTTPS uses a private certificate authority.
• Optional network and query access to InfluxDB v2.
• A PHO licence containing a mosaicoapereceiver entitlement.

Status endpoint configuration

The client certificate and private key must be supplied together.

Optional InfluxDB configuration

Example

extensions:
  pho_license:
    file: /etc/otelcol/license.json

receivers:
  mosaicoapereceiver:
    scheme: https
    host: mosaicoa-pe.example.com
    port: 8443
    path: /status
    timeout: 10s
    collection_interval: 30s
    tls:
      ca_file: /etc/otelcol/mosaicoa-ca.pem
      insecure_skip_verify: false
    influx:
      enabled: true
      endpoint: https://influxdb.example.com:8086
      org: CJC
      bucket: EVENT/EVENT
      token: ${env:INFLUX_TOKEN}
      gateways: [GATEWAY-1, GATEWAY-2]
      lookback: 90m
      timeout: 30s

processors:
  batch: {}

exporters:
  otlp:
    endpoint: telemetry-gateway.example.com:4317

service:
  extensions: [pho_license]
  pipelines:
    metrics:
      receivers: [mosaicoapereceiver]
      processors: [batch]
      exporters: [otlp]

Use an environment variable or an approved secrets manager for the InfluxDB token.

Telemetry

Topic metrics carry the mosaicoa.topic attribute. The InfluxDB metric carries Gateway.

The following resource attributes provide additional context:

• mosaicoa.pe.version
• mosaicoa.pe.generation_time
• mosaicoa.pe.last_reset_time
• mosaicoa.pe.cimp.process_time

Operational behaviour

• A status-endpoint failure affects only the current collection interval.
• Invalid individual status rows are skipped while valid rows remain available.
• An InfluxDB failure does not prevent status-endpoint metrics from being collected.
• A configured gateway with no matching values reports zero.

Troubleshooting