analyze-chart

Chart Deep Dive

When to Use

• A metric spiked or dropped unexpectedly
• You need to understand what’s driving a trend
• Preparing a detailed, evidence-backed analysis for stakeholders
• Investigating differences between user or event segments

Instructions

Step 0: Identify the Chart

• Accept a chart URL or chart ID
• If the user provides a URL, use Amplitude:get_from_url to extract the chart ID
• If no chart identifier is provided, ask explicitly for the chart URL or ID and stop

---

Step 1: Retrieve and Validate Chart Data (Mandatory)

• Use Reading chart data to retrieve the chart definition and data
• If chart data cannot be retrieved or is empty, do not proceed
  • Explain what’s missing (time range, event, filters, permissions)
  • Ask the user to correct the chart or provide a valid chart

Capture and restate:

• Metric being measured
• Time range and granularity
• Chart type (e.g. time series, funnel, retention)
• Existing filters, segments, or breakdowns

---

Step 2: Identify the Pattern and Change Window

Use Analyzing chart to characterize what’s happening:

• Spike / Drop: Sudden change on specific date(s)
• Trend: Gradual increase or decrease over time
• Seasonality: Recurring weekly or monthly patterns
• Anomaly: Deviation from recent baseline or historical behavior

Explicitly identify:

• The window of change (start/end)
• Direction and magnitude of the change
• Baseline period used for comparison (default: previous equal-length period)

---

Step 3: Investigate Likely Drivers (Bounded)

Instead of broad slicing, use guided segmentation:

1. Use Finding the right event properties to identify the most relevant properties for explaining the change
2. Select up to 9 high-signal properties (e.g. platform, country, plan, version)
3. Re-run Analyzing chart with these properties in mind to determine:
   • Which segments contribute most to the change
   • Whether the pattern is localized or broad-based
   • Only fetch up to 3 charts at a time when using Amplitude:query_charts