olakai-troubleshoot

Diagnose and fix Olakai monitoring issues affecting events, KPIs, and SDK integrations.

Updated Jan 15, 2026
One-click install
npx skills add https://github.com/olakai-ai/olakai-skills --skill olakai-troubleshoot
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: olakai-troubleshoot
Source: https://github.com/olakai-ai/olakai-skills/tree/main/skills/olakai-troubleshoot
Command: npx skills add https://github.com/olakai-ai/olakai-skills --skill olakai-troubleshoot

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Diagnoses and fixes Olakai monitoring issues affecting events, KPI data, and SDK integration, so you can restore reliable agent visibility.

Core Features & Use Cases

  • Automated diagnosis of common Olakai issues (no events, null or string KPIs, authentication failures, or misattributed events).
  • Step-by-step remediation guidance and CLI-based checks (whoami, activity list, kpis, custom-data) to resolve root causes.
  • Guidance on preventing recurrence, validating fixes by triggering events and re-checking KPI computations.

Quick Start

Authenticate with the CLI, then run a quick diagnostic by listing recent events for your agent and verifying KPI configurations.

Frequently Asked Questions about olakai-troubleshoot

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

FAQPage Schema
Why are my Olakai monitoring events not appearing for my agent?

Olakai monitoring events may not appear due to authentication failures, SDK integration errors, or misattributed events. Diagnose this by running CLI checks like whoami and activity list to validate configurations and pinpoint the root cause.

How do I fix null or incorrect KPI values in my Olakai monitoring dashboard?

To fix null or incorrect KPI values, run the kpis CLI command to validate your KPI configurations and review custom-data mappings. This diagnostic process identifies misattributed events and suggests remediations to restore accurate KPI computations.

What is the best way to troubleshoot Olakai SDK authentication failures?

The best way to troubleshoot Olakai SDK authentication failures is to run the whoami CLI command to validate credentials. This verifies your authentication status and provides step-by-step remediation guidance to restore reliable agent visibility.

Can I validate fixes after remediating Olakai monitoring issues?

Yes, you can validate fixes by triggering events and re-checking KPI computations using CLI commands. This confirms that events appear correctly, KPIs return accurate values, and misattributed events are resolved across your agents.

How do I diagnose misattributed events across multiple Olakai agents?

Diagnose misattributed events by running the activity list and custom-data CLI commands to review event routing and SDK configurations. This validates that events are correctly attributed to the appropriate agents and enforces best practices.