executor
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.