autumn-investigate

Investigate Autumn request logs and Stripe webhook deliveries to explain billing and usage anomalies.

2.7k|244|Updated Jan 21, 2025
One-click install
npx skills add https://github.com/useautumn/autumn --skill autumn-investigate
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: autumn-investigate
Source: https://github.com/useautumn/autumn/tree/main/packages/agent-docs/generated/skills/autumn-investigate
Command: npx skills add https://github.com/useautumn/autumn --skill autumn-investigate

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

When a customer reports an unexpected charge, a denied feature check, missing usage resets, or a subscription that is out of sync between Autumn and Stripe, you need a structured way to find out what actually happened instead of guessing. This Skill turns raw request logs and webhook deliveries into a clear, timestamped answer.

Core Features & Use Cases

  • Two-pass log investigation: Locate incident windows with aggregate queries, then drill into full request and response payloads for the exact records that matter.
  • Domain-specific recipes: Dedicated references for billing timelines (duplicate charges, plan changes, cancellations), balance and usage discrepancies (denied checks, missing resets, rollovers), and Stripe webhook delivery analysis.
  • Delivery vs processing diagnosis: Distinguish whether a Stripe event was processed, failed inside Autumn, or never arrived, so issues get routed to the right owner.
  • Use Case: A customer says they were charged twice this month. The Skill anchors the customer and time window, aggregates billing activity by day, lists the attach calls and invoice webhooks, and reports which requests created each charge.

Quick Start

Ask the agent to investigate why a specific customer was charged twice last week using their customer ID and the autumn-investigate skill.

Frequently Asked Questions about autumn-investigate

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

FAQPage Schema
How do I investigate why a customer was charged twice in Autumn?

List billing calls and invoice webhooks around the charge time filtered by customer_id, then compare response_body invoice ids across repeated billing.attach requests. Multiple invoice.paid webhooks with different invoice ids indicate separate charges that each need tracing.

How do I debug a denied feature check in Autumn?

Query request logs for records where response_body.allowed is false for the customer, then read balance.remaining, next_reset_at, and breakdown on the denial. Walk backwards through track calls to find the usage that drained the balance.

What is the difference between searchRequestLogs and queryRequestLogs?

searchRequestLogs returns full request records with payloads and is capped at 7 days per call, while queryRequestLogs returns aggregate rows via summarize and is capped at 30 days when filtering by customer_id. Always pass an explicit range since search defaults to only 30 minutes.

Can request logs show why a usage reset did not happen?

Logs can show that balances did not reset by comparing remaining and next_reset_at across checks straddling the boundary, but resets are internal processing. The logs show the effect, not the cause, so confirmed cases should be escalated to Autumn support.

How do I tell if a Stripe webhook reached Autumn?

Filter logs by source equal to stripe_webhook and the customer_id, then check status_code: 200 means processed, 400 or above means Autumn received but failed to process it, and no record means Stripe never delivered it. Each outcome has a different owner for the fix.

What are the limitations of the Autumn request log query language?

The pipeline syntax supports only where, summarize, project, order by, and limit stages with a fixed field list, and there is no full-text search. Payload access is limited to dot paths under request_body and response_body with at most four segments.