[

Description

Run synthetic checks against configured URLs and push OTEL metrics.

Synopsis

java ... io.yupiik.fusion.framework.api.main.Launcher \
    executor \
    --checks-$index-attributes ...\
    --checks-$index-connection-host ...\
    --checks-$index-connection-port ...\
    --checks-$index-connection-proxy-host ...\
    --checks-$index-connection-proxy-port ...\
    --checks-$index-connection-proxy-type ...\
    --checks-$index-connection-timeout ...\
    --checks-$index-dns-expectedAddresses ...\
    --checks-$index-dns-hostname ...\
    --checks-$index-dns-timeout ...\
    --checks-$index-http-assertions-$index-expected-value ...\
    --checks-$index-http-assertions-$index-json-pointer ...\
    --checks-$index-http-assertions-$index-operator ...\
    --checks-$index-http-body ...\
    --checks-$index-http-expected-status ...\
    --checks-$index-http-followRedirects ...\
    --checks-$index-http-headers ...\
    --checks-$index-http-method ...\
    --checks-$index-http-ssl-certificates ...\
    --checks-$index-http-ssl-client-certificate ...\
    --checks-$index-http-ssl-client-private-key ...\
    --checks-$index-http-ssl-trust-all-certificates ...\
    --checks-$index-http-timeout ...\
    --checks-$index-http-url ...\
    --checks-$index-http-version ...\
    --checks-$index-jdbc-driver ...\
    --checks-$index-jdbc-password ...\
    --checks-$index-jdbc-timeout ...\
    --checks-$index-jdbc-url ...\
    --checks-$index-jdbc-username ...\
    --checks-$index-jdbc-validation-query ...\
    --checks-$index-name ...\
    --checks-$index-type ...\
    --checks-$index-x509-allow-self-signed ...\
    --checks-$index-x509-expected-fingerprint ...\
    --checks-$index-x509-expected-issuer ...\
    --checks-$index-x509-expected-sans ...\
    --checks-$index-x509-expected-subject ...\
    --checks-$index-x509-host ...\
    --checks-$index-x509-min-days-until-expiration ...\
    --checks-$index-x509-port ...\
    --checks-$index-x509-sni ...\
    --checks-$index-x509-timeout ...\
    --checks-$index-x509-verify-hostname ...\
    --default-timeout ...\
    --execution-timeout ...\
    --max-concurrent-per-type ...\
    --opentelemetry-endpoint ...\
    --opentelemetry-flatten-attributes ...\
    --opentelemetry-headers ...\
    --opentelemetry-httpVersion ...\
    --opentelemetry-protocol ...\
    --opentelemetry-resource-attributes ...\
    --opentelemetry-scope-attributes ...\
    --opentelemetry-ssl-certificates ...\
    --opentelemetry-ssl-client-certificate ...\
    --opentelemetry-ssl-client-private-key ...\
    --thread-per-type ...

Parameters

--checks-$index-attributes
Check custom attributes.
--checks-$index-connection-host
Host to connect to.
--checks-$index-connection-port
Port to connect to.
--checks-$index-connection-proxy-host
Proxy host.
--checks-$index-connection-proxy-port
Proxy port.
--checks-$index-connection-proxy-type
Proxy type: HTTP, SOCKS (SOCKS5), SOCKS4 (or SOCKS4a), or DIRECT.
--checks-$index-connection-timeout
Custom (java duration formatted) timeout for this check.
--checks-$index-dns-expectedAddresses
Optional list of expected resolved IP addresses.
--checks-$index-dns-hostname
Hostname to resolve.
--checks-$index-dns-timeout
Custom (java duration formatted) timeout for this check.
--checks-$index-http-assertions-$index-expected-value
Expected value
--checks-$index-http-assertions-$index-json-pointer
JSON-Pointer to extract.
--checks-$index-http-assertions-$index-operator
Expected value
--checks-$index-http-body

For write methods, the payload to send.

--checks-$index-http-expected-status
Expected response status.
--checks-$index-http-followRedirects
Should redirects be followed.
--checks-$index-http-headers
HTTP headers to set.
--checks-$index-http-method
HTTP method to use.
--checks-$index-http-ssl-certificates
Trusted CA certificates in PEM format for custom SSL trust.
--checks-$index-http-ssl-client-certificate
Client certificate in PEM format for mTLS.
--checks-$index-http-ssl-client-private-key
Client private key in PEM format (PKCS#8) for mTLS.
--checks-$index-http-ssl-trust-all-certificates
Enable to trust all certificates (do not enable for production environment.
--checks-$index-http-timeout
Custom (java duration formatted) timeout for this check.
--checks-$index-http-url
URL to call.
--checks-$index-http-version
HTTP protocol version.
--checks-$index-jdbc-driver
JDBC driver (if needed, recent drivers can be loaded from the classpath).
--checks-$index-jdbc-password
JDBC password, prefer using secret injection for this.
--checks-$index-jdbc-timeout
Custom (java duration formatted) timeout for this check.
--checks-$index-jdbc-url
JDBC URL.
--checks-$index-jdbc-username
JDBC username.
--checks-$index-jdbc-validation-query
SQL query to validate the connection.
--checks-$index-name
Check name (or an internal one is generated).
--checks-$index-type
Type of the validation.
--checks-$index-x509-allow-self-signed
Whether to accept self-signed certificates.
--checks-$index-x509-expected-fingerprint
Expected SHA-256 fingerprint (hex, colon-separated or continuous).
--checks-$index-x509-expected-issuer
Expected Issuer DN regex pattern.
--checks-$index-x509-expected-sans
Expected Subject Alternative Names.
--checks-$index-x509-expected-subject
Expected Subject DN regex pattern.
--checks-$index-x509-host
Hostname to connect to.
--checks-$index-x509-min-days-until-expiration
Minimum days before certificate expiration.
--checks-$index-x509-port
Port to connect to.
--checks-$index-x509-sni

SNI hostname (defaults to host).

--checks-$index-x509-timeout
Custom (java duration formatted) timeout for this check.
--checks-$index-x509-verify-hostname
Verify hostname matches certificate SAN/CN.
--default-timeout
Default timeout per check.
--execution-timeout
Default timeout for the whole execution.
--max-concurrent-per-type
Max parallel checks per type.
--opentelemetry-endpoint
OpenTelemetry collector HTTP endpoint for metrics.
--opentelemetry-flatten-attributes
Should resource and/or scope attributes be merged with metrics attributes. Mainly useful when prometheus is not configured to handle global attributes.
--opentelemetry-headers
Headers to send to respect OpenTelemetry collector endpoint.
--opentelemetry-httpVersion
HTTP protocol version for the collector connection.
--opentelemetry-protocol
Serialization protocol: JSON or PROTOBUF.
--opentelemetry-resource-attributes
Resource attributes (e.g. service.name, service.version).
--opentelemetry-scope-attributes
Instrumentation scope attributes (e.g. name, version).
--opentelemetry-ssl-certificates
Trusted CA certificates in PEM format for custom SSL trust.
--opentelemetry-ssl-client-certificate
Client certificate in PEM format for mTLS.
--opentelemetry-ssl-client-private-key
Client private key in PEM format (PKCS#8) for mTLS.
--thread-per-type
Thread mode: <0 synchronous, 0 virtual threads, >0 fixed pool size.