notebooks

Create and manage Datadog Notebooks with markdown and visualization cells via the pup CLI.

5|2|Updated Mar 9, 2026
One-click install
npx skills add https://github.com/lauhon/pi --skill notebooks-lauhon
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: notebooks
Source: https://github.com/lauhon/pi/tree/main/skills/notebooks
Command: npx skills add https://github.com/lauhon/pi --skill notebooks-lauhon

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Manually building Datadog Notebooks for incident investigations, weekly reports, and runbooks is repetitive and slow, especially when combining documentation with live metric, log, and trace visualizations. ## Core Features & Use Cases - Notebook CRUD Operations: Create, list, get, update, and delete Datadog Notebooks through the pup CLI with author filtering and pagination. - Mixed Content Cells: Build notebooks combining markdown documentation with timeseries, toplist, heatmap, distribution, and log stream visualization cells. - Flexible Time Ranges: Set global notebook time spans (relative or absolute) and override time ranges per individual cell. - Use Case: During an incident, create an investigation notebook with a markdown timeline, a timeseries graph of request duration, a toplist of slowest queries, and an error log stream, all scoped to the last 4 hours. ## Quick Start Create a Datadog notebook named "Incident Investigation" with a markdown summary cell and a timeseries cell showing production error rates over the last 4 hours.

Frequently Asked Questions about notebooks

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

FAQPage Schema
How do I create a Datadog notebook from the command line?

Use the pup notebooks create command with a --name flag and a --cells JSON array defining each cell's type and content. You can also set a global time range with the --time flag, such as a relative live_span of 1h or 1w.

What cell types can Datadog notebooks contain?

Datadog notebooks support markdown cells for documentation and visualization cells including timeseries, toplist, heatmap, distribution, and log stream. Each visualization cell accepts Datadog query syntax and a graph size from xs to xl.

How do I filter Datadog notebooks by author?

Use pup notebooks list with the --author flag to show notebooks from a specific user, or --exclude-author to omit one. Pagination is available through the --start and --count flags.

Can I set different time ranges for individual notebook cells?

Yes, each cell accepts a time attribute that overrides the notebook's global time range. Set it to a relative span like 24h or an absolute start and end, or use null to inherit the global time.

Why does the notebooks command fail with a credentials error?

The pup CLI requires DD_API_KEY and DD_APP_KEY environment variables, plus DD_SITE if not using datadoghq.com. Write operations also require API and application keys with notebooks write permissions.