knowledge-technology

Map real incidents to Tsuga metric names and query patterns per technology.

2|Updated May 28, 2026
One-click install
npx skills add https://github.com/tsuga-dev/agent-plugins --skill knowledge-technology
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: knowledge-technology
Source: https://github.com/tsuga-dev/agent-plugins/tree/main/plugins/tsuga/skills/knowledge-technology
Command: npx skills add https://github.com/tsuga-dev/agent-plugins --skill knowledge-technology

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill solves the problem of mismatching source-system metric names to Tsuga metric identifiers, by providing per-technology reference bundles with exact Tsuga metric names, incident shapes, derived signals, and log patterns so you can query Tsuga reliably instead of guessing.

Core Features & Use Cases

  • Per-technology reference bundles: Each supported technology has its own folder under references/ with an upstream README, a complete metrics inventory (including the exact tsuga_metric_name), and a queries guide with incident shapes, derived signals, and log patterns.
  • Tsuga metric-name correctness: Enforces using tsuga_metric_name from each tech’s metrics.csv for all tsuga aggregation / logs / traces queries, including AWS metrics (e.g., aws_rds_cpu_utilization) where CloudWatch source names do not work directly.
  • Investigation and query composition guidance: Provides generic investigation rules (bad window vs good control window) and concrete patterns for composing tsuga aggregation queries using the required schema and time-range/metric fields.

Quick Start

Use the knowledge-technology skill to find the exact tsuga_metric_name for a tech (such as Postgres) from its metrics.csv, then run tsuga aggregation queries using that metric and a defined incident time window.

Frequently Asked Questions about knowledge-technology

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I map source-system metric names to Tsuga identifiers for incident triage?

Per-technology reference bundles map source-system metrics to exact Tsuga metric names from each tech's metrics.csv, ensuring reliable incident triage instead of guessing identifiers. You avoid query failures by using the mapped Tsuga names for all aggregation, logs, and traces queries.

What's the best way to compose Tsuga aggregation queries for a specific technology?

Tsuga aggregation query composition follows ready-to-use CLI patterns that honor the Tsuga schema, bounded time-range filters, and bad-window versus control-window investigation. Each technology bundle provides concrete incident shapes and derived signals to guide correct queries.

Why do my AWS CloudWatch metric names fail when querying Tsuga aggregation data?

AWS CloudWatch source names fail because Tsuga requires its own metric identifiers, such as aws_rds_cpu_utilization, instead of native source-system names. You must use the exact tsuga_metric_name from the technology's metrics.csv to execute valid aggregation, logs, and traces queries.

Does this reference cover log patterns and derived signals for technologies like Postgres?

Yes, per-technology reference bundles cover approximately 35 technologies including Postgres, providing complete metrics inventories, incident shapes, derived signals, and log patterns. Each technology has a dedicated folder with an upstream README and a queries guide.

How do I investigate an incident using bad windows versus control windows in Tsuga?

Investigation uses generic rules comparing the bad incident window against a good control window to isolate anomalies. The reference bundles provide concrete query composition patterns that apply bounded time-range filters to Tsuga aggregation metrics for accurate triage.

Can I use native monitor names to query Tsuga metrics when symptoms mention a covered technology?

No, native monitor or source-system names cannot be used to query Tsuga metrics directly. You must look up the exact tsuga_metric_name from the relevant technology's metrics.csv file and use that identifier for all subsequent Tsuga aggregation, logs, and traces queries.