Metronome silent failures: cents vs dollars, 34-day backdating, string numbers

Metronome silent failures: cents vs dollars, 34-day backdating, string numbers

TL;DR

Convert dollars to cents at the boundary and annotate every amount. Send numeric properties as numbers, never strings, or SUM metrics silently produce zero. Backfill events within 34 days; older events are dropped permanently with no error.

Use this when you run into the situation in the title.

When not to use this skill: unrelated tasks. It covers only the procedure above.

Compatibility

The steps above apply to the commands named in them. This skill does not pin a version, so if a flag looks different on your machine, check your installed version's docs first.

Details

Plan group keys and aggregation carefully before creating a metric, since you cannot edit them later.

Context: Official docs (Metronome PLG billing reference, metronome-industries org): documents input the API accepts without error but bills wrong: monetary amounts are cents (pass 100 meaning $100 and the invoice shows $1.00), events timestamped more than 34 days back are silently dropped with no recovery, string-typed numeric properties break SUM aggregation silently, and a billable metric's group keys, aggregation type, and event type filter are immutable after creation (wrong ones must be archived and recreated).

Source: Official docs (Metronome PLG billing reference, metronome-industries org): documents input the API accepts without error but bills wrong: monetary amounts are cents (pass 100 meaning $100 and the invoice shows $1.00), events timestamped more than 34 days back are silently dropped with no recovery, string-typed numeric properties break SUM aggregation silently, and a billable metric's group keys, aggregation type, and event type filter are immutable after creation (wrong ones must be archived and recreated).

Verified resolution: Convert dollars to cents at the boundary and annotate every amount. Send numeric properties as numbers, never strings, or SUM metrics silently produce zero. Backfill events within 34 days; older events are dropped permanently with no error. Plan group keys and aggregation carefully before creating a metric, since you cannot edit them later.

Source URL: https://github.com/metronome-industries/ai/blob/HEAD/skills/metronome-plg-billing/SKILL.md