Clever Cloud Fetch
CertifiedFetch application runtime logs for a Clever Cloud application
Clever Cloud Fetch
Fetch application runtime logs for a Clever Cloud application
Retrieves application runtime logs emitted within a bounded time window, via the Clever Cloud APIv4 logs endpoint (GET /v4/logs/organisations/{organisationId}/applications/{applicationId}/logs).
This endpoint is Server-Sent Events (SSE) based even for a bounded fetch, and the server is not guaranteed to close the connection once "until" is reached. This task never depends on that: it always returns whatever log lines it collected, at the latest once maxDuration elapses, or sooner once idleTimeout passes with no new log line. Set until explicitly (rather than leaving it open-ended) to fetch a historical window; use logs.Stream instead to tail logs as they are produced.
organisationId is always required here: unlike the rest of this plugin, the v4 logs API has no /self shortcut for personal accounts.
type: io.kestra.plugin.clevercloud.logs.FetchExamples
Fetch logs produced since the start of this flow execution
id: post_deploy_log_check
namespace: company.team
tasks:
- id: fetch_logs
type: io.kestra.plugin.clevercloud.logs.Fetch
apiToken: "{{ secret('CC_API_TOKEN') }}"
organisationId: "orga_xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
applicationId: "app_xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
since: "{{ execution.startDate }}"
limit: 200
- id: log_output
type: io.kestra.plugin.core.log.Log
message: "Captured {{ outputs.fetch_logs.total }} log lines"
Properties
apiToken *Requiredstring
API token
Bearer token for the Clever Cloud API. Store as a Kestra secret and reference with {{ secret('CC_API_TOKEN') }}.
applicationId *Requiredstring
Application ID
organisationId *Requiredstring
Organisation ID
The Clever Cloud organisation or personal account ID that owns the application (orga_xxx or user_xxx). Unlike the rest of this plugin, the v4 logs and log drain APIs have no /self shortcut, so this is always required.
since *Requiredstring
Start of the time range to fetch logs from
ISO-8601 instant. Only logs emitted at or after this time are returned.
fetchType string
FETCHSTOREFETCHFETCH_ONENONEHow to fetch the results
FETCH returns all items, FETCH_ONE returns the first item, STORE saves them to internal storage as an ion file, NONE returns only the count.
filter string
Server-side text filter
Optional free-text filter applied by the Clever Cloud API before logs are returned.
idleTimeout string
PT10SMaximum time to wait without receiving a new log line before returning
ISO-8601 duration. Returns early with whatever was collected once no new log line arrives for this long, so a quiet application does not wait out the full maxDuration. Defaults to PT10S, must be between PT1S and maxDuration.
limit integerstring
100Maximum number of log lines to return
Defaults to 100. Must be between 1 and 10000.
maxDuration string
PT30SMaximum time to wait for the SSE stream before returning
ISO-8601 duration. Hard client-side cap so this task always returns, even if the underlying SSE connection never closes on its own. Whatever log lines were collected by then are returned. Defaults to PT30S, must be between PT1S and PT5M.
options Non-dynamic
HTTP client options
Optional HttpConfiguration applied to every Clever Cloud API call, including timeouts and proxy settings.
io.kestra.core.http.client.configurations.HttpConfiguration
falseIf true, allow a failed response code (response code >= 400)
List of response code allowed for this request
The authentication to use.
io.kestra.core.http.client.configurations.BasicAuthConfiguration
The password for HTTP basic authentication.
The username for HTTP basic authentication.
io.kestra.core.http.client.configurations.BearerAuthConfiguration
The token for bearer token authentication.
io.kestra.core.http.client.configurations.DigestAuthConfiguration
The password for HTTP Digest authentication.
The username for HTTP Digest authentication.
The password for HTTP basic authentication. Deprecated, use auth property with a BasicAuthConfiguration instance instead.
The username for HTTP basic authentication. Deprecated, use auth property with a BasicAuthConfiguration instance instead.
durationThe time allowed to establish a connection to the server before failing.
durationThe time an idle connection can remain in the client's connection pool before being closed.
UTF-8The default charset for the request.
java.nio.charset.Charset
trueWhether to enable TCP Keep-Alive extended socket options (TCP_KEEPIDLE, TCP_KEEPINTERVAL, TCP_KEEPCOUNT).
Set to false when running on Windows workers, as these extended socket options are not supported by the Windows JDK and will cause connection failures.
trueWhether redirects should be followed automatically.
ALLTRACEDEBUGINFOWARNERROROFFNOT_SPECIFIEDThe log level for the HTTP client.
REQUEST_HEADERSREQUEST_BODYRESPONSE_HEADERSRESPONSE_BODYThe enabled log.
The maximum content length of the response.
The proxy configuration.
io.kestra.core.http.client.configurations.ProxyConfiguration
The address of the proxy server.
The password for proxy authentication.
The port of the proxy server.
DIRECTDIRECTHTTPSOCKSThe type of proxy to use.
The username for proxy authentication.
The address of the proxy server.
The password for proxy authentication.
The port of the proxy server.
DIRECTHTTPSOCKSThe type of proxy to use.
The username for proxy authentication.
durationThe time allowed for a read connection to remain idle before closing it.
durationThe maximum time allowed for reading data from the server before failing.
The SSL request options
io.kestra.core.http.client.configurations.SslOptions
Whether to disable checking of the remote SSL certificate.
Only applies if no trust store is configured. Note: This makes the SSL connection insecure and should only be used for testing. If you are using a self-signed certificate, set up a trust store instead.
The timeout configuration.
io.kestra.core.http.client.configurations.TimeoutConfiguration
The time allowed to establish a connection to the server before failing.
PT5MThe time allowed for a read connection to remain idle before closing it.
pluginDefaultsRef Non-dynamicstring
Reference (ref) of the pluginDefaults to apply to this task.
until string
End of the time range to fetch logs from
ISO-8601 instant, defaults to now. Only logs emitted before this time are returned; the task stops consuming the stream once a log line at or after this time is seen.
Outputs
log
First log line returned by the API
Populated when fetchType is FETCH_ONE, null if no log line was found.
io.kestra.plugin.clevercloud.logs.model.LogEntry
date-timelogs array
Log lines returned by the API
Populated when fetchType is FETCH.
io.kestra.plugin.clevercloud.logs.model.LogEntry
date-timetotal integer
0Total number of log lines returned
uri string
uriURI of the stored log lines
Populated when fetchType is STORE, points to an ion file in Kestra internal storage.
