[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M78Z6PTYKEPSWHXQZZ4JDB04":3,"skill-same:01M78Z6PTYKEPSWHXQZZ4JDB04":58},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":35,"commitSha":36,"skillDirectory":37,"forksCount":38,"repositoryHtmlUrl":39,"repositoryHomepageUrl":6,"ownerHtmlUrl":40,"ownerBlogUrl":41,"ownerDescription":42,"updatedAt":43,"install":44,"resources":57},"01M78Z6PTYKEPSWHXQZZ4JDB04","customerio-observability",null,"Set up Customer.io monitoring and observability.\nUse when implementing metrics, structured logging, alerting,\nor Grafana dashboards for Customer.io integrations.\nTrigger: \"customer.io monitoring\", \"customer.io metrics\",\n\"customer.io dashboard\", \"customer.io alerts\", \"customer.io observability\".","jukeyman\u002Fjukeyman-skills","jukeyman","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F142960420?v=4","01M78FR4Y3DHMMCBCC0GXXNB3F","RICK JEFFERSON","01M78FR4Z8RVQRAD31Y5J7V6EB",1,"MIT","https:\u002F\u002Fgithub.com\u002Fjukeyman\u002Fjukeyman-skills\u002Fblob\u002Fmain\u002Fskills\u002Fsaas-packs--customerio-pack--customerio-observability\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: customerio-observability\ndescription: |\n  Set up Customer.io monitoring and observability.\n  Use when implementing metrics, structured logging, alerting,\n  or Grafana dashboards for Customer.io integrations.\n  Trigger: \"customer.io monitoring\", \"customer.io metrics\",\n  \"customer.io dashboard\", \"customer.io alerts\", \"customer.io observability\".\nallowed-tools: Read, Write, Edit, Bash(npm:*), Bash(npx:*), Glob, Grep\nversion: 1.0.0\nlicense: MIT\nauthor: Jeremy Longshore \u003Cjeremy@intentsolutions.io>\ncompatible-with: claude-code, codex, openclaw\ntags: [saas, customer-io, monitoring, observability, prometheus]\n---\n# Customer.io Observability\n\n## Overview\n\nImplement comprehensive observability for Customer.io integrations: Prometheus metrics (latency, error rates, delivery funnel), structured JSON logging with PII redaction, OpenTelemetry tracing, and Grafana dashboard definitions.\n\n## Prerequisites\n\n- Customer.io integration deployed\n- Prometheus + Grafana (or compatible metrics stack)\n- Structured logging system (pino recommended)\n\n## Key Metrics to Track\n\n| Metric | Type | Description | Alert Threshold |\n|--------|------|-------------|----------------|\n| `cio_api_duration_ms` | Histogram | API call latency | p99 > 5000ms |\n| `cio_api_requests_total` | Counter | Total API requests by operation | N\u002FA (rate) |\n| `cio_api_errors_total` | Counter | API errors by status code | > 1% error rate |\n| `cio_email_sent_total` | Counter | Transactional + campaign emails | N\u002FA |\n| `cio_email_bounced_total` | Counter | Bounce count | > 5% of sends |\n| `cio_email_complained_total` | Counter | Spam complaints | > 0.1% of sends |\n| `cio_webhook_received_total` | Counter | Webhook events by metric type | N\u002FA |\n| `cio_queue_depth` | Gauge | Pending items in event queue | > 10K |\n\n## Instructions\n\n### Step 1: Prometheus Metrics\n\n```typescript\n\u002F\u002F lib\u002Fcustomerio-metrics.ts\nimport { Counter, Histogram, Gauge, Registry } from \"prom-client\";\n\nconst registry = new Registry();\n\nexport const cioMetrics = {\n  apiDuration: new Histogram({\n    name: \"cio_api_duration_ms\",\n    help: \"Customer.io API call duration in milliseconds\",\n    labelNames: [\"operation\", \"status\"] as const,\n    buckets: [10, 25, 50, 100, 250, 500, 1000, 2500, 5000],\n    registers: [registry],\n  }),\n\n  apiRequests: new Counter({\n    name: \"cio_api_requests_total\",\n    help: \"Total Customer.io API requests\",\n    labelNames: [\"operation\"] as const,\n    registers: [registry],\n  }),\n\n  apiErrors: new Counter({\n    name: \"cio_api_errors_total\",\n    help: \"Customer.io API errors\",\n    labelNames: [\"operation\", \"status_code\"] as const,\n    registers: [registry],\n  }),\n\n  emailSent: new Counter({\n    name: \"cio_email_sent_total\",\n    help: \"Emails sent via Customer.io\",\n    labelNames: [\"type\"] as const,  \u002F\u002F \"transactional\" or \"campaign\"\n    registers: [registry],\n  }),\n\n  emailBounced: new Counter({\n    name: \"cio_email_bounced_total\",\n    help: \"Email bounces from Customer.io webhooks\",\n    registers: [registry],\n  }),\n\n  emailComplained: new Counter({\n    name: \"cio_email_complained_total\",\n    help: \"Spam complaints from Customer.io webhooks\",\n    registers: [registry],\n  }),\n\n  webhookReceived: new Counter({\n    name: \"cio_webhook_received_total\",\n    help: \"Webhook events received\",\n    labelNames: [\"metric\"] as const,\n    registers: [registry],\n  }),\n\n  queueDepth: new Gauge({\n    name: \"cio_queue_depth\",\n    help: \"Pending items in Customer.io event queue\",\n    labelNames: [\"queue\"] as const,\n    registers: [registry],\n  }),\n};\n\nexport { registry };\n```\n\n### Step 2: Instrumented Client\n\n```typescript\n\u002F\u002F lib\u002Fcustomerio-instrumented.ts\nimport { TrackClient, APIClient, SendEmailRequest, RegionUS } from \"customerio-node\";\nimport { cioMetrics } from \".\u002Fcustomerio-metrics\";\n\nexport class InstrumentedCioClient {\n  private track: TrackClient;\n  private app: APIClient;\n\n  constructor(siteId: string, trackKey: string, appKey: string) {\n    this.track = new TrackClient(siteId, trackKey, { region: RegionUS });\n    this.app = new APIClient(appKey, { region: RegionUS });\n  }\n\n  async identify(userId: string, attrs: Record\u003Cstring, any>): Promise\u003Cvoid> {\n    const timer = cioMetrics.apiDuration.startTimer({ operation: \"identify\" });\n    cioMetrics.apiRequests.inc({ operation: \"identify\" });\n\n    try {\n      await this.track.identify(userId, attrs);\n      timer({ status: \"success\" });\n    } catch (err: any) {\n      const code = String(err.statusCode ?? \"unknown\");\n      timer({ status: \"error\" });\n      cioMetrics.apiErrors.inc({ operation: \"identify\", status_code: code });\n      throw err;\n    }\n  }\n\n  async trackEvent(\n    userId: string,\n    name: string,\n    data?: Record\u003Cstring, any>\n  ): Promise\u003Cvoid> {\n    const timer = cioMetrics.apiDuration.startTimer({ operation: \"track\" });\n    cioMetrics.apiRequests.inc({ operation: \"track\" });\n\n    try {\n      await this.track.track(userId, { name, data });\n      timer({ status: \"success\" });\n    } catch (err: any) {\n      timer({ status: \"error\" });\n      cioMetrics.apiErrors.inc({\n        operation: \"track\",\n        status_code: String(err.statusCode ?? \"unknown\"),\n      });\n      throw err;\n    }\n  }\n\n  async sendEmail(request: SendEmailRequest): Promise\u003Cany> {\n    const timer = cioMetrics.apiDuration.startTimer({ operation: \"send_email\" });\n    cioMetrics.apiRequests.inc({ operation: \"send_email\" });\n\n    try {\n      const result = await this.app.sendEmail(request);\n      timer({ status: \"success\" });\n      cioMetrics.emailSent.inc({ type: \"transactional\" });\n      return result;\n    } catch (err: any) {\n      timer({ status: \"error\" });\n      cioMetrics.apiErrors.inc({\n        operation: \"send_email\",\n        status_code: String(err.statusCode ?? \"unknown\"),\n      });\n      throw err;\n    }\n  }\n}\n```\n\n### Step 3: Structured Logging with PII Redaction\n\n```typescript\n\u002F\u002F lib\u002Fcustomerio-logger.ts\nimport pino from \"pino\";\n\nconst logger = pino({\n  name: \"customerio\",\n  level: process.env.CUSTOMERIO_LOG_LEVEL ?? \"info\",\n  redact: {\n    paths: [\n      \"*.email\",\n      \"*.phone\",\n      \"*.ip_address\",\n      \"*.password\",\n      \"attrs.email\",\n      \"attrs.phone\",\n    ],\n    censor: \"[REDACTED]\",\n  },\n});\n\nexport function logCioOperation(\n  operation: string,\n  data: {\n    userId?: string;\n    event?: string;\n    latencyMs?: number;\n    statusCode?: number;\n    error?: string;\n    attrs?: Record\u003Cstring, any>;\n  }\n): void {\n  if (data.error) {\n    logger.error({ operation, ...data }, `CIO ${operation} failed`);\n  } else {\n    logger.info({ operation, ...data }, `CIO ${operation} completed`);\n  }\n}\n\n\u002F\u002F Usage:\n\u002F\u002F logCioOperation(\"identify\", {\n\u002F\u002F   userId: \"user-123\",\n\u002F\u002F   latencyMs: 85,\n\u002F\u002F   attrs: { email: \"user@example.com\", plan: \"pro\" }\n\u002F\u002F });\n\u002F\u002F Output: {\"level\":\"info\",\"operation\":\"identify\",\"userId\":\"user-123\",\n\u002F\u002F          \"latencyMs\":85,\"attrs\":{\"email\":\"[REDACTED]\",\"plan\":\"pro\"},\n\u002F\u002F          \"msg\":\"CIO identify completed\"}\n```\n\n### Step 4: Webhook Metrics Collection\n\n```typescript\n\u002F\u002F Integrate with webhook handler (see customerio-webhooks-events skill)\nfunction recordWebhookMetrics(event: { metric: string }): void {\n  cioMetrics.webhookReceived.inc({ metric: event.metric });\n\n  switch (event.metric) {\n    case \"bounced\":\n      cioMetrics.emailBounced.inc();\n      break;\n    case \"spammed\":\n      cioMetrics.emailComplained.inc();\n      break;\n    case \"sent\":\n      cioMetrics.emailSent.inc({ type: \"campaign\" });\n      break;\n  }\n}\n```\n\n### Step 5: Prometheus Metrics Endpoint\n\n```typescript\n\u002F\u002F routes\u002Fmetrics.ts\nimport { Router } from \"express\";\nimport { registry } from \"..\u002Flib\u002Fcustomerio-metrics\";\n\nconst router = Router();\n\nrouter.get(\"\u002Fmetrics\", async (_req, res) => {\n  res.set(\"Content-Type\", registry.contentType);\n  res.end(await registry.metrics());\n});\n\nexport default router;\n```\n\n### Step 6: Grafana Dashboard (JSON Model)\n\n```json\n{\n  \"title\": \"Customer.io Integration\",\n  \"panels\": [\n    {\n      \"title\": \"API Latency (p50\u002Fp95\u002Fp99)\",\n      \"type\": \"timeseries\",\n      \"targets\": [\n        { \"expr\": \"histogram_quantile(0.50, rate(cio_api_duration_ms_bucket[5m]))\" },\n        { \"expr\": \"histogram_quantile(0.95, rate(cio_api_duration_ms_bucket[5m]))\" },\n        { \"expr\": \"histogram_quantile(0.99, rate(cio_api_duration_ms_bucket[5m]))\" }\n      ]\n    },\n    {\n      \"title\": \"Request Rate by Operation\",\n      \"type\": \"timeseries\",\n      \"targets\": [\n        { \"expr\": \"rate(cio_api_requests_total[5m])\" }\n      ]\n    },\n    {\n      \"title\": \"Error Rate %\",\n      \"type\": \"stat\",\n      \"targets\": [\n        { \"expr\": \"rate(cio_api_errors_total[5m]) \u002F rate(cio_api_requests_total[5m]) * 100\" }\n      ]\n    },\n    {\n      \"title\": \"Email Delivery Funnel\",\n      \"type\": \"bargauge\",\n      \"targets\": [\n        { \"expr\": \"cio_email_sent_total\" },\n        { \"expr\": \"cio_email_bounced_total\" },\n        { \"expr\": \"cio_email_complained_total\" }\n      ]\n    }\n  ]\n}\n```\n\n### Step 7: Alerting Rules\n\n```yaml\n# prometheus\u002Fcustomerio-alerts.yml\ngroups:\n  - name: customerio\n    rules:\n      - alert: CioHighErrorRate\n        expr: rate(cio_api_errors_total[5m]) \u002F rate(cio_api_requests_total[5m]) > 0.05\n        for: 5m\n        labels: { severity: critical }\n        annotations:\n          summary: \"Customer.io API error rate > 5%\"\n\n      - alert: CioHighLatency\n        expr: histogram_quantile(0.99, rate(cio_api_duration_ms_bucket[5m])) > 5000\n        for: 5m\n        labels: { severity: warning }\n        annotations:\n          summary: \"Customer.io p99 latency > 5 seconds\"\n\n      - alert: CioHighBounceRate\n        expr: rate(cio_email_bounced_total[1h]) \u002F rate(cio_email_sent_total[1h]) > 0.05\n        for: 15m\n        labels: { severity: warning }\n        annotations:\n          summary: \"Email bounce rate > 5%\"\n\n      - alert: CioSpamComplaints\n        expr: rate(cio_email_complained_total[1h]) \u002F rate(cio_email_sent_total[1h]) > 0.001\n        for: 5m\n        labels: { severity: critical }\n        annotations:\n          summary: \"Spam complaint rate > 0.1% — sender reputation at risk\"\n```\n\n## Error Handling\n\n| Issue | Solution |\n|-------|----------|\n| High cardinality metrics | Don't use userId as a label — use operation + status only |\n| Log volume too high | Set `CUSTOMERIO_LOG_LEVEL=warn` in production |\n| Missing metrics | Check metric registration and scrape config |\n| PII in logs | Verify pino redact paths cover all sensitive fields |\n\n## Resources\n\n- [Prometheus Best Practices](https:\u002F\u002Fprometheus.io\u002Fdocs\u002Fpractices\u002F)\n- [Grafana Dashboard Provisioning](https:\u002F\u002Fgrafana.com\u002Fdocs\u002Fgrafana\u002Flatest\u002Fdashboards\u002F)\n- [pino Logger](https:\u002F\u002Fgetpino.io\u002F)\n\n## Next Steps\n\nAfter observability setup, proceed to `customerio-advanced-troubleshooting` for debugging.\n","# Customer.io Observability\n\n## Overview\n\nImplement comprehensive observability for Customer.io integrations: Prometheus metrics (latency, error rates, delivery funnel), structured JSON logging with PII redaction, OpenTelemetry tracing, and Grafana dashboard definitions.\n\n## Prerequisites\n\n- Customer.io integration deployed\n- Prometheus + Grafana (or compatible metrics stack)\n- Structured logging system (pino recommended)\n\n## Key Metrics to Track\n\n| Metric | Type | Description | Alert Threshold |\n|--------|------|-------------|----------------|\n| `cio_api_duration_ms` | Histogram | API call latency | p99 > 5000ms |\n| `cio_api_requests_total` | Counter | Total API requests by operation | N\u002FA (rate) |\n| `cio_api_errors_total` | Counter | API errors by status code | > 1% error rate |\n| `cio_email_sent_total` | Counter | Transactional + campaign emails | N\u002FA |\n| `cio_email_bounced_total` | Counter | Bounce count | > 5% of sends |\n| `cio_email_complained_total` | Counter | Spam complaints | > 0.1% of sends |\n| `cio_webhook_received_total` | Counter | Webhook events by metric type | N\u002FA |\n| `cio_queue_depth` | Gauge | Pending items in event queue | > 10K |\n\n## Instructions\n\n### Step 1: Prometheus Metrics\n\n```typescript\n\u002F\u002F lib\u002Fcustomerio-metrics.ts\nimport { Counter, Histogram, Gauge, Registry } from \"prom-client\";\n\nconst registry = new Registry();\n\nexport const cioMetrics = {\n  apiDuration: new Histogram({\n    name: \"cio_api_duration_ms\",\n    help: \"Customer.io API call duration in milliseconds\",\n    labelNames: [\"operation\", \"status\"] as const,\n    buckets: [10, 25, 50, 100, 250, 500, 1000, 2500, 5000],\n    registers: [registry],\n  }),\n\n  apiRequests: new Counter({\n    name: \"cio_api_requests_total\",\n    help: \"Total Customer.io API requests\",\n    labelNames: [\"operation\"] as const,\n    registers: [registry],\n  }),\n\n  apiErrors: new Counter({\n    name: \"cio_api_errors_total\",\n    help: \"Customer.io API errors\",\n    labelNames: [\"operation\", \"status_code\"] as const,\n    registers: [registry],\n  }),\n\n  emailSent: new Counter({\n    name: \"cio_email_sent_total\",\n    help: \"Emails sent via Customer.io\",\n    labelNames: [\"type\"] as const,  \u002F\u002F \"transactional\" or \"campaign\"\n    registers: [registry],\n  }),\n\n  emailBounced: new Counter({\n    name: \"cio_email_bounced_total\",\n    help: \"Email bounces from Customer.io webhooks\",\n    registers: [registry],\n  }),\n\n  emailComplained: new Counter({\n    name: \"cio_email_complained_total\",\n    help: \"Spam complaints from Customer.io webhooks\",\n    registers: [registry],\n  }),\n\n  webhookReceived: new Counter({\n    name: \"cio_webhook_received_total\",\n    help: \"Webhook events received\",\n    labelNames: [\"metric\"] as const,\n    registers: [registry],\n  }),\n\n  queueDepth: new Gauge({\n    name: \"cio_queue_depth\",\n    help: \"Pending items in Customer.io event queue\",\n    labelNames: [\"queue\"] as const,\n    registers: [registry],\n  }),\n};\n\nexport { registry };\n```\n\n### Step 2: Instrumented Client\n\n```typescript\n\u002F\u002F lib\u002Fcustomerio-instrumented.ts\nimport { TrackClient, APIClient, SendEmailRequest, RegionUS } from \"customerio-node\";\nimport { cioMetrics } from \".\u002Fcustomerio-metrics\";\n\nexport class InstrumentedCioClient {\n  private track: TrackClient;\n  private app: APIClient;\n\n  constructor(siteId: string, trackKey: string, appKey: string) {\n    this.track = new TrackClient(siteId, trackKey, { region: RegionUS });\n    this.app = new APIClient(appKey, { region: RegionUS });\n  }\n\n  async identify(userId: string, attrs: Record\u003Cstring, any>): Promise\u003Cvoid> {\n    const timer = cioMetrics.apiDuration.startTimer({ operation: \"identify\" });\n    cioMetrics.apiRequests.inc({ operation: \"identify\" });\n\n    try {\n      await this.track.identify(userId, attrs);\n      timer({ status: \"success\" });\n    } catch (err: any) {\n      const code = String(err.statusCode ?? \"unknown\");\n      timer({ status: \"error\" });\n      cioMetrics.apiErrors.inc({ operation: \"identify\", status_code: code });\n      throw err;\n    }\n  }\n\n  async trackEvent(\n    userId: string,\n    name: string,\n    data?: Record\u003Cstring, any>\n  ): Promise\u003Cvoid> {\n    const timer = cioMetrics.apiDuration.startTimer({ operation: \"track\" });\n    cioMetrics.apiRequests.inc({ operation: \"track\" });\n\n    try {\n      await this.track.track(userId, { name, data });\n      timer({ status: \"success\" });\n    } catch (err: any) {\n      timer({ status: \"error\" });\n      cioMetrics.apiErrors.inc({\n        operation: \"track\",\n        status_code: String(err.statusCode ?? \"unknown\"),\n      });\n      throw err;\n    }\n  }\n\n  async sendEmail(request: SendEmailRequest): Promise\u003Cany> {\n    const timer = cioMetrics.apiDuration.startTimer({ operation: \"send_email\" });\n    cioMetrics.apiRequests.inc({ operation: \"send_email\" });\n\n    try {\n      const result = await this.app.sendEmail(request);\n      timer({ status: \"success\" });\n      cioMetrics.emailSent.inc({ type: \"transactional\" });\n      return result;\n    } catch (err: any) {\n      timer({ status: \"error\" });\n      cioMetrics.apiErrors.inc({\n        operation: \"send_email\",\n        status_code: String(err.statusCode ?? \"unknown\"),\n      });\n      throw err;\n    }\n  }\n}\n```\n\n### Step 3: Structured Logging with PII Redaction\n\n```typescript\n\u002F\u002F lib\u002Fcustomerio-logger.ts\nimport pino from \"pino\";\n\nconst logger = pino({\n  name: \"customerio\",\n  level: process.env.CUSTOMERIO_LOG_LEVEL ?? \"info\",\n  redact: {\n    paths: [\n      \"*.email\",\n      \"*.phone\",\n      \"*.ip_address\",\n      \"*.password\",\n      \"attrs.email\",\n      \"attrs.phone\",\n    ],\n    censor: \"[REDACTED]\",\n  },\n});\n\nexport function logCioOperation(\n  operation: string,\n  data: {\n    userId?: string;\n    event?: string;\n    latencyMs?: number;\n    statusCode?: number;\n    error?: string;\n    attrs?: Record\u003Cstring, any>;\n  }\n): void {\n  if (data.error) {\n    logger.error({ operation, ...data }, `CIO ${operation} failed`);\n  } else {\n    logger.info({ operation, ...data }, `CIO ${operation} completed`);\n  }\n}\n\n\u002F\u002F Usage:\n\u002F\u002F logCioOperation(\"identify\", {\n\u002F\u002F   userId: \"user-123\",\n\u002F\u002F   latencyMs: 85,\n\u002F\u002F   attrs: { email: \"user@example.com\", plan: \"pro\" }\n\u002F\u002F });\n\u002F\u002F Output: {\"level\":\"info\",\"operation\":\"identify\",\"userId\":\"user-123\",\n\u002F\u002F          \"latencyMs\":85,\"attrs\":{\"email\":\"[REDACTED]\",\"plan\":\"pro\"},\n\u002F\u002F          \"msg\":\"CIO identify completed\"}\n```\n\n### Step 4: Webhook Metrics Collection\n\n```typescript\n\u002F\u002F Integrate with webhook handler (see customerio-webhooks-events skill)\nfunction recordWebhookMetrics(event: { metric: string }): void {\n  cioMetrics.webhookReceived.inc({ metric: event.metric });\n\n  switch (event.metric) {\n    case \"bounced\":\n      cioMetrics.emailBounced.inc();\n      break;\n    case \"spammed\":\n      cioMetrics.emailComplained.inc();\n      break;\n    case \"sent\":\n      cioMetrics.emailSent.inc({ type: \"campaign\" });\n      break;\n  }\n}\n```\n\n### Step 5: Prometheus Metrics Endpoint\n\n```typescript\n\u002F\u002F routes\u002Fmetrics.ts\nimport { Router } from \"express\";\nimport { registry } from \"..\u002Flib\u002Fcustomerio-metrics\";\n\nconst router = Router();\n\nrouter.get(\"\u002Fmetrics\", async (_req, res) => {\n  res.set(\"Content-Type\", registry.contentType);\n  res.end(await registry.metrics());\n});\n\nexport default router;\n```\n\n### Step 6: Grafana Dashboard (JSON Model)\n\n```json\n{\n  \"title\": \"Customer.io Integration\",\n  \"panels\": [\n    {\n      \"title\": \"API Latency (p50\u002Fp95\u002Fp99)\",\n      \"type\": \"timeseries\",\n      \"targets\": [\n        { \"expr\": \"histogram_quantile(0.50, rate(cio_api_duration_ms_bucket[5m]))\" },\n        { \"expr\": \"histogram_quantile(0.95, rate(cio_api_duration_ms_bucket[5m]))\" },\n        { \"expr\": \"histogram_quantile(0.99, rate(cio_api_duration_ms_bucket[5m]))\" }\n      ]\n    },\n    {\n      \"title\": \"Request Rate by Operation\",\n      \"type\": \"timeseries\",\n      \"targets\": [\n        { \"expr\": \"rate(cio_api_requests_total[5m])\" }\n      ]\n    },\n    {\n      \"title\": \"Error Rate %\",\n      \"type\": \"stat\",\n      \"targets\": [\n        { \"expr\": \"rate(cio_api_errors_total[5m]) \u002F rate(cio_api_requests_total[5m]) * 100\" }\n      ]\n    },\n    {\n      \"title\": \"Email Delivery Funnel\",\n      \"type\": \"bargauge\",\n      \"targets\": [\n        { \"expr\": \"cio_email_sent_total\" },\n        { \"expr\": \"cio_email_bounced_total\" },\n        { \"expr\": \"cio_email_complained_total\" }\n      ]\n    }\n  ]\n}\n```\n\n### Step 7: Alerting Rules\n\n```yaml\n# prometheus\u002Fcustomerio-alerts.yml\ngroups:\n  - name: customerio\n    rules:\n      - alert: CioHighErrorRate\n        expr: rate(cio_api_errors_total[5m]) \u002F rate(cio_api_requests_total[5m]) > 0.05\n        for: 5m\n        labels: { severity: critical }\n        annotations:\n          summary: \"Customer.io API error rate > 5%\"\n\n      - alert: CioHighLatency\n        expr: histogram_quantile(0.99, rate(cio_api_duration_ms_bucket[5m])) > 5000\n        for: 5m\n        labels: { severity: warning }\n        annotations:\n          summary: \"Customer.io p99 latency > 5 seconds\"\n\n      - alert: CioHighBounceRate\n        expr: rate(cio_email_bounced_total[1h]) \u002F rate(cio_email_sent_total[1h]) > 0.05\n        for: 15m\n        labels: { severity: warning }\n        annotations:\n          summary: \"Email bounce rate > 5%\"\n\n      - alert: CioSpamComplaints\n        expr: rate(cio_email_complained_total[1h]) \u002F rate(cio_email_sent_total[1h]) > 0.001\n        for: 5m\n        labels: { severity: critical }\n        annotations:\n          summary: \"Spam complaint rate > 0.1% — sender reputation at risk\"\n```\n\n## Error Handling\n\n| Issue | Solution |\n|-------|----------|\n| High cardinality metrics | Don't use userId as a label — use operation + status only |\n| Log volume too high | Set `CUSTOMERIO_LOG_LEVEL=warn` in production |\n| Missing metrics | Check metric registration and scrape config |\n| PII in logs | Verify pino redact paths cover all sensitive fields |\n\n## Resources\n\n- [Prometheus Best Practices](https:\u002F\u002Fprometheus.io\u002Fdocs\u002Fpractices\u002F)\n- [Grafana Dashboard Provisioning](https:\u002F\u002Fgrafana.com\u002Fdocs\u002Fgrafana\u002Flatest\u002Fdashboards\u002F)\n- [pino Logger](https:\u002F\u002Fgetpino.io\u002F)\n\n## Next Steps\n\nAfter observability setup, proceed to `customerio-advanced-troubleshooting` for debugging.\n",{"name":5,"tags":24,"author":30,"license":15,"version":31,"description":32,"allowed-tools":33,"compatible-with":34},[25,26,27,28,29],"saas","customer-io","monitoring","observability","prometheus","Jeremy Longshore \u003Cjeremy@intentsolutions.io>","1.0.0","Set up Customer.io monitoring and observability.\nUse when implementing metrics, structured logging, alerting,\nor Grafana dashboards for Customer.io integrations.\nTrigger: \"customer.io monitoring\", \"customer.io metrics\",\n\"customer.io dashboard\", \"customer.io alerts\", \"customer.io observability\".\n","Read, Write, Edit, Bash(npm:*), Bash(npx:*), Glob, Grep","claude-code, codex, openclaw","main","99825ad3f3bcc6597ddcc7294a14e6e922f2b67b","skills\u002Fsaas-packs--customerio-pack--customerio-observability",0,"https:\u002F\u002Fgithub.com\u002Fjukeyman\u002Fjukeyman-skills","https:\u002F\u002Fgithub.com\u002Fjukeyman","https:\u002F\u002FRJBUSINESSSOLUTIONS.ORG","Credit and Finance Expert | Developer\r\n\r\nI'm Rick Jefferson, a seasoned credit and finance expert with over a decade of experience in financial literacy,","2026-07-13 07:03:29",{"source":8,"skillName":5,"commands":45,"prompt":55,"zipAvailable":56},[46,49,52],{"tool":47,"command":48},"npx","npx skills add jukeyman\u002Fjukeyman-skills --skill customerio-observability",{"tool":50,"command":51},"bunx","bunx skills add jukeyman\u002Fjukeyman-skills --skill customerio-observability",{"tool":53,"command":54},"pnpm","pnpm dlx skills add jukeyman\u002Fjukeyman-skills --skill customerio-observability","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fjukeyman\u002Fjukeyman-skills\u002Fblob\u002Fmain\u002Fskills\u002Fsaas-packs--customerio-pack--customerio-observability\u002FSKILL.md",true,[],[59,66,73,80,87,95],{"skillNo":60,"name":61,"nameZh":6,"description":62,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":63,"categories":64,"keywords":65,"publishedAt":19},"01M79ANS2SM329NEP5ZCX106RR","zustand-store-creator","Create zustand store creator operations. Auto-activating skill for Frontend Development.\nTriggers on: zustand store creator, zustand store creator\nPart of the Frontend Development skill category. Use when working with zustand store creator functionality. Trigger with phrases like \"zustand store creator\", \"zustand creator\", \"zustand\".","https:\u002F\u002Fgithub.com\u002Fjukeyman\u002Fjukeyman-skills\u002Fblob\u002Fmain\u002Fskills\u002Fzustand-store-creator\u002FSKILL.md",[],[],{"skillNo":67,"name":68,"nameZh":6,"description":69,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":70,"categories":71,"keywords":72,"publishedAt":19},"01M79AMZKP4YDEZ7EHG1Y7PP74","zero-trust-config-helper","Configure with zero trust config helper operations. Auto-activating skill for Security Advanced.\nTriggers on: zero trust config helper, zero trust config helper\nPart of the Security Advanced skill category. Use when configuring systems or services. Trigger with phrases like \"zero trust config helper\", \"zero helper\", \"zero\".","https:\u002F\u002Fgithub.com\u002Fjukeyman\u002Fjukeyman-skills\u002Fblob\u002Fmain\u002Fskills\u002Fzero-trust-config-helper\u002FSKILL.md",[],[],{"skillNo":74,"name":75,"nameZh":6,"description":76,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":77,"categories":78,"keywords":79,"publishedAt":19},"01M79AMJSBCEJQNBTYNAHYN5HM","zapier-integration-helper","Assist with zapier integration helper operations. Auto-activating skill for Business Automation.\nTriggers on: zapier integration helper, zapier integration helper\nPart of the Business Automation skill category. Use when working with APIs or building integrations. Trigger with phrases like \"zapier integration helper\", \"zapier helper\", \"zapier\".","https:\u002F\u002Fgithub.com\u002Fjukeyman\u002Fjukeyman-skills\u002Fblob\u002Fmain\u002Fskills\u002Fzapier-integration-helper\u002FSKILL.md",[],[],{"skillNo":81,"name":82,"nameZh":6,"description":83,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":84,"categories":85,"keywords":86,"publishedAt":19},"01M79AHJZGVMARS13VFQYRR1MP","yaml-config-validator","Validate yaml config validator operations. Auto-activating skill for DevOps Basics.\nTriggers on: yaml config validator, yaml config validator\nPart of the DevOps Basics skill category. Use when configuring systems or services. Trigger with phrases like \"yaml config validator\", \"yaml validator\", \"yaml\".","https:\u002F\u002Fgithub.com\u002Fjukeyman\u002Fjukeyman-skills\u002Fblob\u002Fmain\u002Fskills\u002Fyaml-config-validator\u002FSKILL.md",[],[],{"skillNo":88,"name":89,"nameZh":6,"description":90,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":91,"sourceHtmlUrl":92,"categories":93,"keywords":94,"publishedAt":19},"01M79AHGDZRN0020RDQSQDPAM8","xvary-stock-research","Thesis-driven equity analysis from public SEC EDGAR and market data; \u002Fanalyze, \u002Fscore, \u002Fcompare workflows with bundled Python tools (Claude Code, Cursor, Codex).","https:\u002F\u002Fgithub.com\u002Fjukeyman\u002Fjukeyman-skills\u002Fblob\u002Fmain\u002Fskills\u002Fxvary-stock-research\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fjukeyman\u002Fjukeyman-skills\u002Fblob\u002Fmain\u002Fskills\u002Fxvary-stock-research\u002FSKILL.md",[],[],{"skillNo":96,"name":97,"nameZh":6,"description":98,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":99,"categories":100,"keywords":101,"publishedAt":19},"01M79AHCYJ9FV9RMHQ24HDRN33","xss-vulnerability-scanner","Scan xss vulnerability scanner operations. Auto-activating skill for Security Fundamentals.\nTriggers on: xss vulnerability scanner, xss vulnerability scanner\nPart of the Security Fundamentals skill category. Use when working with xss vulnerability scanner functionality. Trigger with phrases like \"xss vulnerability scanner\", \"xss scanner\", \"xss\".","https:\u002F\u002Fgithub.com\u002Fjukeyman\u002Fjukeyman-skills\u002Fblob\u002Fmain\u002Fskills\u002Fxss-vulnerability-scanner\u002FSKILL.md",[],[]]