Getting Started
Welcome to Eventkiwi! This guide will help you start collecting and aggregating your application events in minutes.
What is Eventkiwi?
Eventkiwi is an event aggregation platform that transforms your event chaos into scheduled summaries. Instead of being overwhelmed by constant event streams, you receive organized reports on your schedule—hourly, daily, weekly, or monthly—by email or in Telegram.
Quick Start
To start using Eventkiwi, you'll need:
- An Eventkiwi account - Sign up at app.eventkiwi.com
- An aggregator - Create one from your dashboard to get a unique event collection URL
- Your API key - Shown on the aggregator page under Show Request Examples (with your keys). See Authentication
Once you have these, you can start sending events immediately using simple HTTP requests.
Core Concepts
Aggregators
An aggregator is a container for your events. Each aggregator has:
- A unique ID for collecting events
- A schedule for when reports are sent
- Configured channels for receiving reports (email and Telegram)
Events
Events are the data points you send to Eventkiwi. Each event has:
- A name (required) - identifies the type of event (e.g., "user_signup", "checkout_completed")
- Tags (optional) - labels that split an event's count in reports, like
plan-proorsource-google
Reports
Reports are automatically generated summaries of your events, sent according to your aggregator's schedule. They include:
- A short written summary of what changed, at the top
- Event counts, with the change against the previous report
- Per-event sparklines
- Tag breakdowns
Reports are delivered to every channel you have connected - by email, to a Telegram chat, or both. See Schedules and Reports and Delivery Channels.
In the app
- Dashboard - your aggregators with their schedule, event count and trend, plus your plan usage
- Event Log - every event received, with its tags, filterable by event name and aggregator
- Reports - every report that has been sent, with its written summary
- Channels - connect Telegram, send a test report, reconnect a stopped chat
- Plan Settings - your plan, event usage and billing
Next Steps
- Schedules and Reports - When reports go out and what they contain
- Delivery Channels - Get reports by email or in Telegram
- Authentication - Learn how to authenticate your API requests
- Sending Events - Start sending events to your aggregator
- Event Tags - Add metadata to your events for better insights