profile

Profile FrogDB CPU, async tasks, memory, and metrics.

7|Updated Jan 7, 2026
One-click install
npx skills add https://github.com/frogdb/frogdb --skill profile-frogdb
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: profile
Source: https://github.com/frogdb/frogdb/tree/main/.claude/skills/profile
Command: npx skills add https://github.com/frogdb/frogdb --skill profile-frogdb

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires samply, tracing-flame, tokio-coz, heaptrack, tokio-metrics, and includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This skill addresses the need for performance profiling in FrogDB by providing tools to analyze CPU usage, async tasks, memory allocations, and more.

Core Features & Use Cases

  • CPU Sampling: Analyze where CPU time is spent using samply.
  • Async Flamegraphs: Visualize async task execution with tracing-flame.
  • Causal Profiling: Understand the impact of code performance on overall throughput with tokio-coz.
  • Memory Profiling: Identify memory allocation hotspots using heaptrack.
  • Always-On Metrics: Continuously monitor metrics with tokio-metrics.

Quick Start

Run the just profile-load command to start a CPU sampling profile of FrogDB.

Frequently Asked Questions about profile

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

FAQPage Schema
How do I profile CPU usage in a Redis-compatible database?

You can profile CPU usage using the `samply` tool integrated for CPU sampling. Run the `just profile-load` command to quickly start analyzing where CPU time is spent in your FrogDB environment.

What is causal profiling and how does it impact async throughput?

Causal profiling measures how specific code performance impacts overall throughput. The `tokio-coz` dependency allows you to understand this causal relationship within async task execution.

Can I generate async flamegraphs to visualize task execution?

Yes, async flamegraphs can be generated using the `tracing-flame` dependency. This allows you to visualize asynchronous task execution and identify bottlenecks in concurrent operations.

How do I identify memory allocation hotspots during performance profiling?

Memory profiling identifies allocation hotspots using the `heaptrack` tool. This helps pinpoint exactly where memory allocations occur and accumulate during database operations.

Does this Skill support always-on metrics for continuous monitoring?

Yes, continuous monitoring is supported through the `tokio-metrics` dependency. It provides always-on metrics to track performance characteristics without adding significant overhead.

What tools are best for debugging performance issues in async Rust environments?

The Skill combines `samply` for CPU sampling, `tracing-flame` for async flamegraphs, and `tokio-coz` for causal profiling. This provides a comprehensive toolkit for debugging async Rust performance.