Search docs
Find a page, section or endpoint

Resources

Troubleshooting

Fixes for events that don't show up, empty metrics and empty segments.

Find your symptom, then work through the checks in order.

An event doesn't show on the profile#

A collector 200 only means the event was queued; an event that fails validation afterwards doesn't appear on any profile. For other collector status codes, see Delivery.

  1. Check the event name is registered and lowercase.
  2. Check occured_at and envelop_version are spelled exactly like that. See Events.
  3. Check the event carries at least one identifier of a declared type. From the browser, only cookie and device_id count. See Identifiers.
  4. Check workspace_id is set. Without it, the event lands in default. See Events.
  5. Look the customer up with profile lookup, using an identifier you sent.

A metric is empty#

  1. Check the events arrived after the definition took effect. Metrics only count events received after the definition was created, about a minute after you create it. See Limits & timings.
  2. Check value_path matches the event. It starts with properties.. See Metrics.
  3. Check the value is a number for property_number. See Metrics.

A segment has nobody in it#

  1. Run the rule through preview.
  2. Check for conditions on metrics new customers don't have yet. A condition on a missing metric is false, so customers without that metric are never in. See Segments.

Next#