Every webhook delivery is logged with:<\/p>\n\n\n\n Each webhook endpoint in the dashboard also shows:<\/p>\n\n\n\n You can view the last 50 deliveries per webhook in the Tolinku dashboard<\/a>.<\/p>\n\n\n\n The dashboard shows what Tolinku sent. Your receiver should track what it received and how it processed the events. These metrics form a complete picture.<\/p>\n\n\n\n Events received per minute.<\/strong> Track the count of webhook requests hitting your endpoint. A sudden drop means either Tolinku stopped sending (check the dashboard) or your receiver is unreachable.<\/p>\n\n\n\n Processing latency.<\/strong> Time from receiving the webhook to completing your handler logic (database write, API call, queue push). High processing latency means your handler is doing too much synchronously. Respond with 200 first, then process asynchronously.<\/p>\n\n\n\n Error rate by type.<\/strong> Categorize errors:<\/p>\n\n\n\n Duplicate rate.<\/strong> How often you receive the same event more than once. Some duplication is normal (retries after timeouts), but a high rate might indicate your endpoint is responding too slowly, causing Tolinku to retry events that were actually received.<\/p>\n\n\n\n Log every webhook request with structured fields so you can query and aggregate:<\/p>\n\n\n\n Whether you use Grafana, Datadog, or a custom dashboard, track these panels:<\/p>\n\n\n\n A healthy integration maintains 99%+ success rate. A dip below 95% warrants investigation.<\/p>\n\n\n\n Track the p50, p95, and p99 response times of your endpoint. Tolinku times out after 10 seconds, so if your p95 approaches that threshold, you're at risk of timeouts triggering retries.<\/p>\n\n\n\n Target: p95 under 500ms. If processing takes longer, respond with 200 first and process asynchronously.<\/p>\n\n\n\n A time series of event counts broken down by type. This reveals:<\/p>\n\n\n\n Track how many events arrive as retries (attempt > 1). A rising retry rate means your endpoint is failing more often.<\/p>\n\n\n\n If you can identify retries (by detecting duplicate event hashes), chart the dedup rate over time. Normal is under 1%. Above 5% means something is consistently failing.<\/p>\n\n\n\n Set up alerts for these conditions:<\/p>\n\n\n\n If your receiver hasn't received a webhook in the last N minutes (where N depends on your traffic volume), something is wrong. For high-traffic apps, alert after 5 minutes of silence. For low-traffic apps, alert after 1 hour.<\/p>\n\n\n\n Alert when the error rate exceeds 5% over a 10-minute window. Errors include signature failures, processing exceptions, and downstream failures.<\/p>\n\n\n\n Alert when p95 response time exceeds 5 seconds. At that point, you're at risk of timeouts on the next traffic spike.<\/p>\n\n\n\n Any signature verification failure should trigger an alert. Either someone is sending fake requests to your endpoint, or your webhook secret is misconfigured. Both warrant immediate attention.<\/p>\n\n\n\n Add a health check endpoint to your receiver so your monitoring system can verify it's running:<\/p>\n\n\n\n Point your uptime monitor (UptimeRobot, Pingdom, or a simple cron curl) at this endpoint.<\/p>\n\n\n\n Even with monitoring, events can be lost. Periodic reconciliation compares what Tolinku sent with what your receiver processed.<\/p>\n\n\n\n If the numbers diverge by more than 1-2% (accounting for timing differences at range boundaries), investigate:<\/p>\n\n\n\n Run a daily job that compares counts and alerts on significant discrepancies:<\/p>\n\n\n\n![\"Tolinku](\"https:\/\/tolinku.com\/blog\/wp-content\/uploads\/2026\/03\/platform-webhooks.png\")
\nThe webhooks page with create form, webhook list, and delivery log.<\/em><\/p>\n\n\n\nWhat Tolinku Tracks<\/h2>\n\n\n\n
\n
link.clicked<\/code>)<\/li>\n\n
What You Should Track (Receiver Side)<\/h2>\n\n\n\n
Key Metrics<\/h3>\n\n\n\n
\n
Structured Logging<\/h3>\n\n\n\n
import express from 'express';\nimport crypto from 'crypto';\n\nconst app = express();\napp.use('\/webhooks', express.raw({ type: 'application\/json' }));\n\napp.post('\/webhooks\/tolinku', async (req, res) => {\n const startTime = Date.now();\n const eventType = req.headers['x-webhook-event'] as string;\n\n \/\/ Verify signature\n const signature = req.headers['x-webhook-signature'] as string;\n const expected = crypto\n .createHmac('sha256', process.env.WEBHOOK_SECRET!)\n .update(req.body)\n .digest('hex');\n\n if (signature !== expected) {\n console.log(JSON.stringify({\n level: 'warn',\n type: 'webhook_signature_failed',\n event_type: eventType,\n ip: req.ip,\n }));\n return res.status(401).send('Invalid signature');\n }\n\n \/\/ Respond immediately\n res.status(200).send('OK');\n const responseTime = Date.now() - startTime;\n\n const event = JSON.parse(req.body.toString());\n\n \/\/ Generate dedup key\n const eventHash = crypto\n .createHash('sha256')\n .update(req.body)\n .digest('hex')\n .substring(0, 16);\n\n try {\n await processEvent(event);\n\n console.log(JSON.stringify({\n level: 'info',\n type: 'webhook_processed',\n event_type: eventType,\n event_hash: eventHash,\n response_time_ms: responseTime,\n processing_time_ms: Date.now() - startTime,\n timestamp: event.timestamp,\n }));\n } catch (err: any) {\n console.log(JSON.stringify({\n level: 'error',\n type: 'webhook_processing_failed',\n event_type: eventType,\n event_hash: eventHash,\n error: err.message,\n response_time_ms: responseTime,\n }));\n }\n});\n<\/code><\/pre>\n\n\n\nBuilding a Monitoring Dashboard<\/h2>\n\n\n\n
1. Delivery Success Rate<\/h3>\n\n\n\n
-- Success rate over the last hour (from your receiver logs)\nSELECT\n date_trunc('minute', received_at) AS minute,\n COUNT(*) AS total,\n COUNT(*) FILTER (WHERE status = 'processed') AS success,\n ROUND(\n COUNT(*) FILTER (WHERE status = 'processed')::numeric \/ COUNT(*) * 100,\n 1\n ) AS success_rate\nFROM webhook_logs\nWHERE received_at > NOW() - INTERVAL '1 hour'\nGROUP BY minute\nORDER BY minute;\n<\/code><\/pre>\n\n\n\n2. Response Time Distribution<\/h3>\n\n\n\n
3. Events by Type Over Time<\/h3>\n\n\n\n
\n
link.clicked<\/code>)<\/li>\n4. Retry Rate<\/h3>\n\n\n\n
Alerting<\/h2>\n\n\n\n
No Events Received<\/h3>\n\n\n\n
\/\/ Simple staleness check\nlet lastEventTime = Date.now();\n\napp.post('\/webhooks\/tolinku', (req, res) => {\n lastEventTime = Date.now();\n \/\/ ... process\n});\n\nsetInterval(() => {\n const silenceMinutes = (Date.now() - lastEventTime) \/ 60000;\n if (silenceMinutes > 15) {\n sendAlert(`No webhook events received in ${Math.round(silenceMinutes)} minutes`);\n }\n}, 60000);\n<\/code><\/pre>\n\n\n\nHigh Error Rate<\/h3>\n\n\n\n
Slow Response Times<\/h3>\n\n\n\n
Signature Failures<\/h3>\n\n\n\n
Health Check Endpoint<\/h2>\n\n\n\n
app.get('\/health', (req, res) => {\n const silenceMinutes = (Date.now() - lastEventTime) \/ 60000;\n\n res.json({\n status: 'ok',\n last_event_received: new Date(lastEventTime).toISOString(),\n minutes_since_last_event: Math.round(silenceMinutes),\n uptime_seconds: Math.round(process.uptime()),\n });\n});\n<\/code><\/pre>\n\n\n\nReconciliation<\/h2>\n\n\n\n
Approach<\/h3>\n\n\n\n
\n
\n
Automated Reconciliation<\/h3>\n\n\n\n
async function reconcile() {\n \/\/ Count events your receiver processed yesterday\n const result = await db.query(`\n SELECT event_type, COUNT(*) as count\n FROM webhook_logs\n WHERE received_at >= CURRENT_DATE - INTERVAL '1 day'\n AND received_at < CURRENT_DATE\n GROUP BY event_type\n `);\n\n const receiverCounts = Object.fromEntries(\n result.rows.map(r => [r.event_type, parseInt(r.count)])\n );\n\n \/\/ Compare with expected counts from your analytics\n \/\/ If discrepancy > 2%, alert\n for (const [eventType, count] of Object.entries(receiverCounts)) {\n console.log(`${eventType}: ${count} events received`);\n }\n}\n<\/code><\/pre>\n\n\n\nRunbook: Common Issues<\/h2>\n\n\n\n