Missing or invalid license_file, invalid signature, invalid fingerprint, or expired license outside the grace period.

Configure a valid license_file. For normal deployment, use the embedded public keys compiled into the binary.

The license is expired but still inside the 36-hour grace period.

Replace or renew the license before the grace period ends.

The TOML file contains a key that the parser does not support.

Remove or rename the unsupported key. Use only documented top-level, [[targets]], and [[metric_scopes]] keys.

A [[targets]] entry does not define app.

Add app = "<app-name>" to every [[targets]] table.

A [[targets]] entry does not define server_key.

Add server_key = "<key>" to every [[targets]] table.

The requested target subtree is not fully subscribed and in sync.

Wait for readiness, verify the configured server_key, and rerun with debug = true or --debug for diagnostics.

The request does not include enough routing information.

Include server_key, or include app and instance. If multiple targets share the same app and instance, include server_key too.

A metric scope was selected, but multiple targets are configured.

Add the normal target-routing query parameters, such as ?server_key=82.

HTTP mode is enabled.

This is expected. When the HTTP listener is enabled, periodic Prometheus snapshots are no longer written to stdout.

Debug logging is disabled by default.

Set debug = true in TOML or pass --debug.

The generated build settings do not match your environment.

Re-run ./configure, provide the correct LMC install directory, target platform, and compiler path, then run make again in src.

License validation failed or license_file is missing.

Provide a valid customer license JSON file with --license-file or license_file.

The selected subtree is not fully subscribed and in sync yet, or no metric mappings match the selected app and paths.

Re-run with --debug, confirm the server key and app value, and verify that the selected root is discovered.

The requested target subtree is not ready, or the selected root, target object, or shared-memory server was lost.

Wait for initial sync, confirm the query routing parameters, and check diagnostics with --debug.

Multiple configured targets share the same app and instance.

Include server_key in the scrape query, such as /metrics?server_key=82.

This is expected behavior.

Query the HTTP endpoint instead. When HTTP mode is enabled, periodic snapshots are not written to stdout.

A required value is missing or an option value is invalid.

Check that --server-key is present, --metrics-interval is greater than 0, and --metrics-port is between 1 and 65535.

The requested target subtree is not ready yet.

Wait for the initial sync to complete. If it persists, verify server_key, app, instance, and shared-memory visibility.

Multiple targets are configured and the query does not include enough routing information.

Add server_key, or use a unique app and instance combination.

More than one target has the same app and instance.

Include server_key in the query.

CLI flags such as --server-key or --instance switched the exporter to single-target mode.

Remove the overriding CLI flags or move the target selection into TOML.

The selected app mapping, classes, seed path groups, or seed paths may not match the subscribed data.

Confirm the app value and review any classes, seed_path_groups, or seed_paths filters.

License validation failed or license_file is missing.

Configure a valid license_file. The exporter validates the license before opening the shared-memory pool.

Legacy m_qo_s_* aliases are no longer valid.

Use consumer_mqos_service_service, mqos_service_attributes, and mqos_service_datastreams.