Sources - Docs

Sources are the starting point event-driven architectures and serve as intake of your data.

Creating Sources

New sources can be generated within your dashboard. Once created, you will receive a unique endpoint that can instantly start collecting data.

https://go.proxyhook.com/A817GH

To start tracking data against your new endpoint, send a POST call to it such as the example below.

curl --location 'https://go.proxyhook.com/82hh0k324rq7' \
--header 'Content-Type: application/json' \
--data '{"first-name":"Jeff","last-name":"Dunham","company":"self","email":"[email protected]"}'

All requests to the endpoint will respond with a 1x1 pixel and a status code 200, regardless of any existing subscriptions connected to it. This helps de-couple the reliablility of collecting events from your destinations to overcome overages, outages, rate limits, etc on your destinations and allow advanced retry logic.

Activity

Within the dashboard you are able to view detailed breakdown of Source Activity including number of requests (as a timeseries) , requests per second, execution time as well as filtered requests. You are able to splice the data with custom intervals ranging from 30 minutes to 1 month.

Filters

By default, sources will collect any data that is sent to it, regardless of its content or origin. If you'd like to add fine-grained controls to this, you are able to do so within the Filter section of sources. Filters will not impact the Analytics within Source Activity but will cause the data to not flow through to Logs or any connected Destinations.

Filters can be applied against any of the following and support various conditions such as equals, includes, greater than, less than, etc.

City
State
Country
IP Address
Host
User Agent
Referer
Cookies
Payload Content

Logging

Optionally, you may enable Logging on a specific source and specify a sample rate to collect logs on. This is useful for setup, debugging or if you'd like to create custom Data APIs off a specific source. To set the sample rate and enable logs, simply head to the specific source and it's Logs.