Alibaba Cloud Query

Alibaba Cloud Query

Certified

Query logs from Alibaba Cloud Simple Log Service (SLS)

Queries a Logstore within a project over a specified time range, supporting fetch and store output modes.

yaml
type: io.kestra.plugin.alibaba.sls.Query

Query error logs from an SLS logstore

yaml
id: sls_query
namespace: company.team

tasks:
  - id: query_logs
    type: io.kestra.plugin.alibaba.sls.Query
    accessKeyId: "{{ secret('ALIBABA_ACCESS_KEY_ID') }}"
    accessKeySecret: "{{ secret('ALIBABA_ACCESS_KEY_SECRET') }}"
    region: cn-hangzhou
    project: ops-logs
    logstore: app-events
    query: "level: ERROR"
    fetchType: FETCH
Properties

AccessKey ID

The AccessKey ID used to authenticate against Alibaba Cloud.

AccessKey secret

The AccessKey secret paired with the AccessKey ID.

Logstore

The SLS Logstore name.

Project

The SLS project name.

Assets this task consumes as inputs or produces as outputs, for lineage tracking and the asset graph (Enterprise Edition). A flow declaring this property on a task is rejected in the open-source edition.

Definitions
assetFailureBehaviorstring
Possible Values
IGNOREFAILWARN

Asset failure behavior

Behavior applied to the task state when a declared asset fails to render, emit, or be persisted (e.g. a lock conflict): FAIL escalates it to FAILED, WARN (default) warns it if it would otherwise succeed, IGNORE leaves the state untouched.

enableAutobooleanstring

Whether to auto-register assets referenced dynamically at runtime that are not statically declared in inputs or outputs.

inputsarray

The assets consumed as inputs.

id*string
Min length1
typestring
outputs

The assets produced as outputs.

id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*string
Min length1

Custom asset type

descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150

Endpoint override

Custom http or https endpoint URL. When set, it takes precedence over the endpoint derived from region.

DefaultFETCH
Possible Values
STOREFETCHFETCH_ONENONE

Result handling mode

FETCH, FETCH_ONE, STORE, or NONE. Defaults to FETCH.

From

Start of time range as ISO instant or epoch seconds. Defaults to 15 minutes ago.

Default100

Lines

Number of log lines to return, between 1 and 100; defaults to 100.

Default0

Offset

Non-negative line offset for pagination; defaults to 0.

Default

Query

Search query or SQL analysis statement. Defaults to empty string.

Region

The Alibaba Cloud region ID, for example cn-hangzhou. The service endpoint is derived from it unless endpointOverride is set.

Defaultfalse

Reverse

Sort in reverse chronological order; defaults to false.

Security token

Optional Security Token Service (STS) token, required when using temporary credentials.

To

End of time range as ISO instant or epoch seconds. Defaults to current time.

Default

Topic

The log topic filter. Defaults to empty string.

Total number of log records returned

First fetched log item as a key-value map

Only populated if fetchType is FETCH_ONE

SubTypeobject

Fetched logs as a list of key-value maps

Only populated if fetchType is FETCH

Formaturi

URI of the stored results in internal storage

Only populated if fetchType is STORE