salesforce-observability

# Salesforce Observability ## Overview Instrument Salesforce integrations with API limit monitoring, SOQL performance tracking, error classification, and alerting. Uses Salesforce's built-in Limits API and EventLogFile for deep visibility. ## Prerequisites - jsforce connection configured - Prometheus or compatible metrics backend (optional) - Grafana or similar dashboarding tool (optional) - Salesforce Enterprise+ for EventLogFile access ## Instructions ### Step 1: API Limit Monitoring (Core Metric) ```typescript import { getConnection } from './salesforce/connection'; import { Registry, Gauge, Counter, Histogram } from 'prom-client'; const registry = new Registry(); // The single most important Salesforce metric const apiLimitGauge = new Gauge({ name: 'salesforce_api_limit_remaining', help: 'Remaining daily API calls', registers: [registry], }); const apiLimitMaxGauge = new Gauge({ name: 'salesforce_api_limit_max', help: 'Maximum daily API calls', registers: [registry], }); const apiUsagePercent = new Gauge({ name: 'salesforce_api_usage_percent', help: 'Percentage of daily API calls used', registers: [registry], }); // Poll limits every 5 minutes (each poll = 1 API call) setInterval(async () => { try { const conn = await getConnection(); const limits = await conn.request('/services/data/v59.0/limits/'); apiLimitGauge.set(limits.DailyApiRequests.Remaining); apiLimitMaxGauge.set(limits.DailyApiRequests.Max); const used = limi...