Type object
File match *metricshub.yaml *metricshub.yml
Schema URL https://catalog.lintel.tools/schemas/schemastore/metricshub-configuration/latest.json
Source https://www.schemastore.org/metricshub.json

Validate with Lintel

npx @lintel/lintel check
Type: object

Properties

jobPoolSize integer

Job Pool Size

loggerLevel string

Logger Level (Default: error)

Default: "error"
Values: "all" "trace" "debug" "info" "warn" "error" "fatal" "off"
outputDirectory string

Output directory

collectPeriod duration

Sets the collect period that MetricsHub uses to collects metrics from the monitored resources (Default: 2m).

Default: "2m"
discoveryCycle integer

Sets the cycle that MetricsHub uses to perform discoveries and detect new components in your monitored environment. By default, MetricsHub runs a discovery after 30 collects.

alertingSystemConfig object

Alerting System Configuration

2 nested properties
disable boolean

If true, disables the alerting system

problemTemplate string

Problem alerts template

enableSelfMonitoring boolean

Enables or disables self monitoring signals. E.g. job duration metrics.

sequential boolean

Sequential mode. This forces all network calls to be ordered in a sequential order.

resolveHostnameToFqdn boolean

Resolve hostnames to FQDN (Default: false).

Default: false
jobTimeout duration

Sets how long until the job times out (Default: 5m).

Default: "5m"
otelCollector object

Customizes the OpenTelemetry Collector sub-process.

5 nested properties
commandLine string[]

Overrides the OpenTelemetry Collector command line.

environment object

Configures the OpenTelemetry Collector environment variables.

output string

Configures where to print the OpenTelemetry Collector's output (Default: log).

Default: "log"
Values: "log" "console" "silent"
workingDir string

Configures the working directory of the OpenTelemetry Collector.

disabled boolean

Disables the OpenTelemetry Collector (Default: false).

Default: false
otel Record<string, string>

Internal OpenTelemetry SDK configuration

7 nested properties
otel.exporter.otlp.metrics.endpoint string

The OTLP metrics endpoint URL. Must be an http or https URL, depending on whether TLS is used. For gRPC, the URL is http://localhost:4317 and for HTTP/Protobuf it's http://localhost:4318/v1/metrics

Default: "http://localhost:4317"
otel.exporter.otlp.metrics.protocol string

Property used to configure the transport protocol to use on OTLP metric requests

Default: "grpc"
Values: "grpc" "http/protobuf" "noop"
otel.exporter.otlp.metrics.certificate string

Path to a PEM-formatted file containing trusted certificates for verifying the OTLP server TLS credentials.

otel.exporter.otlp.metrics.headers string

Custom headers to send with OTLP metric requests, typically for authentication.

otel.exporter.otlp.metrics.timeout string

Timeout for OTLP metric requests (in seconds).

Default: "10"
otel.exporter.otlp.metrics.pool.size integer

Exporter pool size. Determines how many metric export operations can run in parallel.

Default: 20
otel.exporter.otlp.metrics.append_resource_attributes boolean

When enabled, all resource attributes will be added as attributes on each exported metric.

Default: false
web Record<string, string>

Web configuration loaded by default. Represents key-value pairs used for web-related settings.

Default:
{}
32 nested properties
server.port string

Server port number.

Default: "31888"
spring.main.banner-mode string

Spring application banner mode (supported values: console, log, off).

Default: "off"
spring.ai.mcp.server.enabled boolean

Enable or disable the MCP server.

Default: true
spring.ai.mcp.server.stdio boolean

Enable communication over STDIO.

Default: false
spring.ai.mcp.server.name string

MCP server name.

Default: "metricshub-mcp-server"
spring.ai.mcp.server.resource-change-notification boolean

Notify on resource changes.

Default: true
spring.ai.mcp.server.tool-change-notification boolean

Notify on tool changes.

Default: true
spring.ai.mcp.server.prompt-change-notification boolean

Notify on prompt changes.

Default: true
spring.ai.mcp.server.sse-endpoint string

SSE endpoint for server events.

Default: "/sse"
spring.ai.mcp.server.sse-message-endpoint string

SSE endpoint for messages.

Default: "/mcp/message"
spring.ai.mcp.server.type string

MCP server type (sync or async).

Default: "sync"
spring.ai.mcp.server.capabilities.completion boolean

Enable completion capability.

Default: true
spring.ai.mcp.server.capabilities.prompt boolean

Enable prompt capability.

Default: true
spring.ai.mcp.server.capabilities.resource boolean

Enable resource capability.

Default: true
spring.ai.mcp.server.capabilities.tool boolean

Enable tool capability.

Default: true
spring.ai.mcp.server.request-timeout integer | string
jwt.short_expire integer

JSON Web Token short expire value (jwt).

Default: 3600
jwt.long_expire integer

JSON Web Token long expire value (refresh).

Default: 86400
jwt.secret string

Secret key used for signing JWT tokens.

Default: ""
tls.enabled boolean

Enable/disable TLS for the embedded web server; false uses HTTP (Default: true).

Default: true
tls.keystore.path string

Keystore path (supports classpath:); uses bundled keystore by default (Default: classpath:m8b-keystore.p12).

Default: "classpath:m8b-keystore.p12"
tls.keystore.password string

Keystore password (also used as key password) (Default: NOPWD).

Default: "NOPWD"
tls.keystore.key-password string

Optional key password; falls back to keystore password when not set.

tls.keystore.key-alias string

Optional key alias; if unset, first suitable private-key entry is used.

ai.openai.tool-output.max-tool-output-bytes integer

Maximum tool output bytes (Default: 10485760).

Default: 10485760
ai.openai.tool-output.safety-delta-bytes integer

Safety delta bytes (Default: 2097152).

Default: 2097152
ai.openai.tool-output.base-temp-dir string

Base temporary directory (Default: ${java.io.tmpdir}/metricshub/ai).

Default: "${java.io.tmpdir}/metricshub/ai"
ai.openai.api-key string

OpenAI API key.

ai.openai.model string

OpenAI model name (Default: gpt-5.2).

Default: "gpt-5.2"
ai.openai.reasoning.enabled boolean

Enable OpenAI reasoning (Default: true).

Default: true
ai.openai.reasoning.effort string

Reasoning effort (Default: MEDIUM).

Default: "MEDIUM"
Values: "HIGH" "LOW" "MINIMAL" "NONE" "XHIGH" "MEDIUM"
ai.openai.reasoning.summary string

Reasoning summary (Default: AUTO).

Default: "AUTO"
Values: "CONCISE" "DETAILED" "AUTO"
attributes Record<string, string | number>

Top level attributes

metrics Record<string, string | number>

Top level metrics

resources Record<string, object>

Contains Resources

resourceGroups Record<string, object>

Contains Resource Groups

license object

MetricsHub License

5 nested properties
product string

The name of the product the license is for.

organization string

The name of the organization the license is for.

expiresOn string

The expiration date of the license in the format yyyy-MM-dd.

resources integer

The maximum number of resources the license covers.

key string

The license key

stateSetCompression string

Represents the possible compression methods for the state set metrics.

Default: "suppressZeros"
Values: "none" "suppressZeros"
patchDirectory string

The path of the custom connectors directory, connectors will also be loaded from the default directory.

monitorFilters string[]

Monitor inclusion or exclusion in data collection. This parameter accepts '+<monitor_name>' for inclusion and '!<monitor_name>' for exclusion.

minItems=1uniqueItems=true

Definitions

sequential boolean

Sequential mode. This forces all network calls to be ordered in a sequential order.

enableSelfMonitoring boolean

Enables or disables self monitoring signals. E.g. job duration metrics.

duration integer | string
namespace string

Forces a specific namespace for connectors that perform namespace auto-detection (Advanced).

loggerLevel string

Logger Level (Default: error)

resources Record<string, object>

Contains Resources

resultContent string

Result Content Expected

httpMethod string

HTTP Method

executeForEachEntryOf object

Execute For Each Entry

source string
concatMethod string | object
metrics Record<string, object>

Metric definitions describing the collected OpenTelemetry metrics and their metadata (unit, description, and type).

sources Record<string, object>

Contains Sources

computes object[]
transportProtocols string
stateSetCompression string

Represents the possible compression methods for the state set metrics.

monitorFilters string[]

Monitor inclusion or exclusion in data collection. This parameter accepts '+<monitor_name>' for inclusion and '!<monitor_name>' for exclusion.

resolveHostnameToFqdn boolean

Resolve hostnames to FQDN (Default: false).

collectPeriod integer | string
jobTimeout integer | string
hostname array | string

The hostname to which the query is sent.

retryIntervals integer[]

An array of retry intervals (in milliseconds) between request retries.

discoveryCycle integer

Sets the cycle that MetricsHub uses to perform discoveries and detect new components in your monitored environment. By default, MetricsHub runs a discovery after 30 collects.