# Send Alicloud Observability Sls Log Query to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "alicloud-observability-sls-log-query",
    "name": "Alicloud Observability Sls Log Query",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/cinience/alicloud-observability-sls-log-query",
    "canonicalUrl": "https://clawhub.ai/cinience/alicloud-observability-sls-log-query",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/alicloud-observability-sls-log-query",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=alicloud-observability-sls-log-query",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "agents/openai.yaml",
      "references/python-sdk.md",
      "references/query-syntax.md",
      "references/sources.md",
      "references/templates.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-23T16:43:11.935Z",
      "expiresAt": "2026-04-30T16:43:11.935Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
        "contentDisposition": "attachment; filename=\"4claw-imageboard-1.0.1.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/alicloud-observability-sls-log-query"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/alicloud-observability-sls-log-query",
    "downloadUrl": "https://openagent3.xyz/downloads/alicloud-observability-sls-log-query",
    "agentUrl": "https://openagent3.xyz/skills/alicloud-observability-sls-log-query/agent",
    "manifestUrl": "https://openagent3.xyz/skills/alicloud-observability-sls-log-query/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/alicloud-observability-sls-log-query/agent.md"
  }
}
```
## Documentation

### SLS Log Query and Troubleshooting

Use SLS query|analysis syntax and Python SDK for log search, filtering, and analytics.

### Prerequisites

Install SDK (virtual environment recommended to avoid PEP 668 restrictions):

python3 -m venv .venv
. .venv/bin/activate
python -m pip install -U aliyun-log-python-sdk

Configure environment variables:

ALIBABA_CLOUD_ACCESS_KEY_ID
ALIBABA_CLOUD_ACCESS_KEY_SECRET
SLS_ENDPOINT (e.g. cn-hangzhou.log.aliyuncs.com)
SLS_PROJECT
SLS_LOGSTORE(supports a single value or comma-separated values)

### Query Composition

Query clause: filters logs (e.g. status:500).
Analysis clause: statistical aggregation, format query|analysis.
Example: * | SELECT status, count(*) AS pv GROUP BY status

See references/query-syntax.md for full syntax.

### Quickstart (Python SDK)

import os
import time
from aliyun.log import LogClient, GetLogsRequest

client = LogClient(
    os.environ["SLS_ENDPOINT"],
    os.environ["ALIBABA_CLOUD_ACCESS_KEY_ID"],
    os.environ["ALIBABA_CLOUD_ACCESS_KEY_SECRET"],
)

project = os.environ["SLS_PROJECT"]
logstore = os.environ["SLS_LOGSTORE"]

query = "status:500"
start_time = int(time.time()) - 15 * 60
end_time = int(time.time())

request = GetLogsRequest(project, logstore, start_time, end_time, query=query)
response = client.get_logs(request)
for log in response.get_logs():
    print(log.contents)

### Script quickstart

python skills/observability/sls/alicloud-observability-sls-log-query/scripts/query_logs.py \\
  --query "status:500" \\
  --last-minutes 15

Optional args: --project, --logstore(repeatable, or comma-separated values), --endpoint, --start, --end, --last-minutes, --limit, --parallel.

### Troubleshooting script

python skills/observability/sls/alicloud-observability-sls-log-query/scripts/troubleshoot.py \\
  --group-field status \\
  --last-minutes 30 \\
  --limit 20

Optional args: --error-query, --group-field, --limit, --logstore(repeatable, or comma-separated values), --parallel, plus the time range args above.

### Workflow

Ensure Logstore indexing is enabled (queries/analysis fail without index).
Write query clause and append analysis clause when needed.
Execute with SDK/script and inspect results.
Control returned rows with limit; narrow time range when needed.

### Validation

mkdir -p output/alicloud-observability-sls-log-query
for f in skills/observability/sls/alicloud-observability-sls-log-query/scripts/*.py; do
  python3 -m py_compile "$f"
done
echo "py_compile_ok" > output/alicloud-observability-sls-log-query/validate.txt

Pass criteria: command exits 0 and output/alicloud-observability-sls-log-query/validate.txt is generated.

### Output And Evidence

Save artifacts, command outputs, and API response summaries under output/alicloud-observability-sls-log-query/.
Include key parameters (region/resource id/time range) in evidence files for reproducibility.

### References

Syntax and examples:references/query-syntax.md


Python SDK initialization and queries:references/python-sdk.md


Troubleshooting templates:references/templates.md


Source list: references/sources.md
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: cinience
- Version: 1.0.2
## Source health
- Status: healthy
- Source download looks usable.
- Yavira can redirect you to the upstream package for this source.
- Health scope: source
- Reason: direct_download_ok
- Checked at: 2026-04-23T16:43:11.935Z
- Expires at: 2026-04-30T16:43:11.935Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/alicloud-observability-sls-log-query)
- [Send to Agent page](https://openagent3.xyz/skills/alicloud-observability-sls-log-query/agent)
- [JSON manifest](https://openagent3.xyz/skills/alicloud-observability-sls-log-query/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/alicloud-observability-sls-log-query/agent.md)
- [Download page](https://openagent3.xyz/downloads/alicloud-observability-sls-log-query)