alibabacloud-sls-index-config-management

Name: alibabacloud-sls-index-config-management
Author: aliyun

github.com/aliyunCloud & DevOps281281 installsUpdated 1d ago

About alibabacloud-sls-index-config-management

A skill for managing Alibaba Cloud SLS Logstore index configurations, intended for users handling index operations, generating configurations from log samples, or tuning indexes for queries. It routes requests to relevant references and sets credential, security, and write-operation safeguards.

Key features

01View, create, update, and delete indexes
02Generate indexes from structured log samples
03Tune indexes for queries and SQL
04Check credentials and RAM permissions
05Read scenario rules before writes

Use cases

01Inspect or change Logstore index fields and TTL
02Generate a configuration for a Logstore without an index
03Reduce cost or improve write throughput for a query workload

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/aliyun/alibabacloud-aiops-skills --skill alibabacloud-sls-index-config-management

After installing, type/alibabacloud-sls-index-config-managementin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

references/

acceptance-criteria.md

cli-installation-guide.md

generate-index-from-logs.md

manage-index-config.md

manifest.json

optimize-index-config.md

ram-policies.md

related-apis.md

scripts/

user_agent.py

Details

From the project README

Alibaba Cloud SLS Index Configuration Manager

Scenario Description

Use this skill for SLS Logstore index configuration.

This file only covers trigger-time setup, routing, and cross-scenario safety. Read only the reference document needed for the user's request.

Prerequisites

These checks apply when executing cloud operations; log-sample generation can run offline.

Install Aliyun CLI

Run aliyun version to verify the version is >= 3.3.8. If not installed or outdated, follow references/cli-installation-guide.md to install or update.

Check Alibaba Cloud credentials configured

Run aliyun configure list to check if credentials are configured. If no valid profile is shown, STOP here and ask the user to run aliyun configure outside of this session.

Security rules:

NEVER read, echo, or print AK/SK values
NEVER ask the user to paste AK/SK into the conversation
ONLY use aliyun configure list to check credential status

RAM Permission Requirements

On Unauthorized error, surface references/ram-policies.md to the user. Do not retry with a different account without explicit confirmation.

Observability

Run scripts/user_agent.py once per session to generate the UA, then reuse it for all cloud API commands, including request-only dry runs:

SLS_INDEX_USER_AGENT="$(python3 scripts/user_agent.py)" || exit 1
aliyun sls get-index --project <project> --logstore <logstore> \
  --user-agent "$SLS_INDEX_USER_AGENT"

Example generated UA:

AlibabaCloud-Agent-Skills/alibabacloud-sls-index-config-management/59ae5afe2075fc3dc1f0e7e39539c902 skill-version/0.0.1

Routing the Request

Follow the reference matching the user's request:

If the user wants to …	Go to
View / create / update / delete an index, or change a field, TTL, `max_text_len`, full-text, automatic index discovery, log_reduce, etc.	references/manage-index-config.md
Build an index for a Logstore that has none, or rebuild from scratch using user-provided structured log samples	references/generate-index-from-logs.md
Adjust an existing index to support a new query / SQL, reduce cost, or improve write throughput	references/optimize-index-config.md

Mixed requests are common (e.g. "generate an index for these logs and then update it on Logstore X"). Read the relevant scenario docs in order.

Global Rules

No writes without the scenario reference. Before any write operation, read the relevant reference document and follow its confirmation, full-body, rollback, and timing rules.
Preserve discovered indexes. Keep line.auto_text_keys unchanged on updates unless explicitly requested otherwise; see automatic index discovery.
Use exact SLS CLI names. Product is sls; subcommands and flags are kebab-case. Use references/acceptance-criteria.md only when validating command shape or debugging CLI invocation issues.

Reference Documents

Document	Description
references/manage-index-config.md	Index config format and get / create / update / delete command examples
references/generate-index-from-logs.md	Infer a complete index configuration from user-provided structured log samples
references/optimize-index-config.md	Optimize an existing index for query/SQL workload, cost, and write throughput
references/related-apis.md	`GetIndex` / `CreateIndex` / `UpdateIndex` / `DeleteIndex` API & CLI reference
related_apis.yaml	Machine-readable dependent API metadata for this skill
references/ram-policies.md	Minimum and complete RAM policies for index management
references/acceptance-criteria.md	CLI invocation acceptance tests
references/cli-installation-guide.md	Aliyun CLI install, auth modes, profiles

Comments

Markdown supported

Details

Author: aliyun
Repository: aliyun/alibabacloud-aiops-skills
Category: Cloud & DevOps
Installs: 281
GitHub stars: 281

Report

More skills

All skills

lark-apps

open.feishu.cn

732.0k

Develop and host Miaoda (Spark/Miaoda) apps: app creation, local full-stack development, cloud generation and iteration, creative design (UI mockups / interactive prototypes / wireframes / landing pages / dashboards / slide decks / visual exploration), integration of AI-related capabilities, Feishu platform capabilities, or other external capabilities; log/Trace/monitoring metric/PV/UV queries; environment variable management; app collaborators and collaboration permissions; app roles and members; and automation triggers (scheduled / record changes / Webhook / Feishu approvals). Use when users want to develop or create a system, tool, platform, or app; develop locally or in the cloud, modify, deploy, publish, launch, or get a shareable link; create a page or website with HTML and deploy it to Miaoda; design, create a mockup, prototype, wireframe, PPT, deck, or visual exploration; or mention Miaoda/Spark/Miaoda apps (links like `/app/app_xxx` or `/page/<token>`, runtime domains like *.aiforce.cloud), app databases, app file storage, open API Keys, visibility, app collaborators/developer permissions, app roles/role members, production logs, API request volume, error volume, latency, traffic, environment variables, or setting up automation tasks, scheduled triggers, or approval-triggered automation for Miaoda apps. Not for regular cloud drive file uploads (lark-drive), Feishu document editing (lark-doc), or native slide creation (lark-slides).

azure-prepare

github.com/microsoft

571.7k

Prepare azd-based Azure projects for deployment: generates azure.yaml, infrastructure (Bicep/Terraform), and Dockerfiles for the Azure Developer CLI (azd) workflow. USE ONLY when the user explicitly wants to use azd as the deployment tool, or the project already has an azure.yaml file. DO NOT USE FOR: non-azd deployments, Python App Service code-only deploys (use python-appservice-deploy), or cross-cloud migration (use azure-cloud-migrate). WHEN: prepare app for azd, create azure.yaml, set up azd infrastructure, modernize app for Azure with azd, deploy with azd, function app, timer trigger, service bus trigger, event-driven function, managed identity, generate Bicep, generate Terraform, create and deploy to Azure.

wizard

github.com/mattpocock

571.5k

Generate an interactive bash wizard that walks a human through steps only they can perform. Use when provisioning infrastructure, setting up credentials or CI secrets, walking an unfamiliar third-party dashboard, or running a one-off migration or cutover. Don't invoke this for steps the agent can perform itself.

azure-ai

github.com/microsoft

571.2k

Use for Azure AI: Search, Speech, OpenAI, Document Intelligence. Helps with search, vector/hybrid search, speech-to-text, text-to-speech, transcription, OCR. WHEN: AI Search, query search, vector search, hybrid search, semantic search, speech-to-text, text-to-speech, transcribe, OCR, convert text to speech.