[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6CHC87F9WMZW7F5A4TC5QA1":3,"skill-same:01M6CHC87F9WMZW7F5A4TC5QA1":88},{"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":41,"linkOnly":42,"markdownContent":43,"markdownBody":44,"frontMatter":45,"refName":50,"commitSha":51,"skillDirectory":52,"forksCount":53,"repositoryHtmlUrl":54,"repositoryHomepageUrl":6,"ownerHtmlUrl":55,"ownerBlogUrl":56,"ownerDescription":57,"updatedAt":58,"install":59,"resources":72},"01M6CHC87F9WMZW7F5A4TC5QA1","apollo-observability",null,"Set up Apollo.io monitoring and observability.\nUse when implementing logging, metrics, tracing, and alerting\nfor Apollo integrations.\nTrigger with phrases like \"apollo monitoring\", \"apollo metrics\",\n\"apollo observability\", \"apollo logging\", \"apollo alerts\".","Dicklesworthstone\u002Fpi_agent_rust","Dicklesworthstone","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F35050222?v=4","01M6CG26AR942CSVMN1M5E3DSE","Jeff Emanuel","01M6CG26EPP71PSHW1VDS71121",1992,"MIT","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Fplugins-community\u002Fplugins\u002Fsaas-packs\u002Fapollo-pack\u002Fskills\u002Fapollo-observability\u002FSKILL.md",[],[19,20,21,22,23,24,25,26,27,28,29,30,31,32,33,34,35,36,37,38,39,40],"observability","apollo observability","apollo","read","when","implementing","io","alerts","up","use","edit","write","logging","curl","integrations","Bash","SET","kubectl","monitoring","alerting","tracing","metrics","2026-11-10 10:12:30",false,"---\nname: apollo-observability\ndescription: |\n  Set up Apollo.io monitoring and observability.\n  Use when implementing logging, metrics, tracing, and alerting\n  for Apollo integrations.\n  Trigger with phrases like \"apollo monitoring\", \"apollo metrics\",\n  \"apollo observability\", \"apollo logging\", \"apollo alerts\".\nallowed-tools: Read, Write, Edit, Bash(kubectl:*), Bash(curl:*)\nversion: 1.0.0\nlicense: MIT\nauthor: Jeremy Longshore \u003Cjeremy@intentsolutions.io>\n---\n\n# Apollo Observability\n\n## Overview\nComprehensive observability setup for Apollo.io integrations including metrics, logging, tracing, and alerting.\n\n## Metrics with Prometheus\n\n```typescript\n\u002F\u002F src\u002Flib\u002Fapollo\u002Fmetrics.ts\nimport { Registry, Counter, Histogram, Gauge } from 'prom-client';\n\nconst register = new Registry();\n\n\u002F\u002F Request metrics\nexport const apolloRequestsTotal = new Counter({\n  name: 'apollo_requests_total',\n  help: 'Total number of Apollo API requests',\n  labelNames: ['endpoint', 'method', 'status'],\n  registers: [register],\n});\n\nexport const apolloRequestDuration = new Histogram({\n  name: 'apollo_request_duration_seconds',\n  help: 'Duration of Apollo API requests in seconds',\n  labelNames: ['endpoint', 'method'],\n  buckets: [0.1, 0.25, 0.5, 1, 2.5, 5, 10],\n  registers: [register],\n});\n\n\u002F\u002F Rate limit metrics\nexport const apolloRateLimitRemaining = new Gauge({\n  name: 'apollo_rate_limit_remaining',\n  help: 'Remaining Apollo API rate limit',\n  labelNames: ['endpoint'],\n  registers: [register],\n});\n\nexport const apolloRateLimitHits = new Counter({\n  name: 'apollo_rate_limit_hits_total',\n  help: 'Number of times rate limit was hit',\n  registers: [register],\n});\n\n\u002F\u002F Cache metrics\nexport const apolloCacheHits = new Counter({\n  name: 'apollo_cache_hits_total',\n  help: 'Number of Apollo cache hits',\n  labelNames: ['endpoint'],\n  registers: [register],\n});\n\nexport const apolloCacheMisses = new Counter({\n  name: 'apollo_cache_misses_total',\n  help: 'Number of Apollo cache misses',\n  labelNames: ['endpoint'],\n  registers: [register],\n});\n\n\u002F\u002F Credit usage\nexport const apolloCreditsUsed = new Counter({\n  name: 'apollo_credits_used_total',\n  help: 'Total Apollo credits consumed',\n  labelNames: ['operation'],\n  registers: [register],\n});\n\n\u002F\u002F Error tracking\nexport const apolloErrors = new Counter({\n  name: 'apollo_errors_total',\n  help: 'Total Apollo API errors',\n  labelNames: ['endpoint', 'error_type'],\n  registers: [register],\n});\n\nexport { register };\n```\n\n### Instrumented Client\n\n```typescript\n\u002F\u002F src\u002Flib\u002Fapollo\u002Finstrumented-client.ts\nimport { apolloRequestsTotal, apolloRequestDuration, apolloErrors } from '.\u002Fmetrics';\n\nexport class InstrumentedApolloClient {\n  async request\u003CT>(endpoint: string, options: RequestOptions): Promise\u003CT> {\n    const labels = { endpoint, method: options.method || 'POST' };\n    const endTimer = apolloRequestDuration.startTimer(labels);\n\n    try {\n      const response = await this.baseClient.request(endpoint, options);\n\n      apolloRequestsTotal.inc({ ...labels, status: 'success' });\n\n      \u002F\u002F Track rate limit from headers\n      const remaining = response.headers['x-ratelimit-remaining'];\n      if (remaining) {\n        apolloRateLimitRemaining.set({ endpoint }, parseInt(remaining));\n      }\n\n      return response.data;\n    } catch (error: any) {\n      const errorType = this.classifyError(error);\n      apolloRequestsTotal.inc({ ...labels, status: 'error' });\n      apolloErrors.inc({ endpoint, error_type: errorType });\n\n      if (error.response?.status === 429) {\n        apolloRateLimitHits.inc();\n      }\n\n      throw error;\n    } finally {\n      endTimer();\n    }\n  }\n\n  private classifyError(error: any): string {\n    const status = error.response?.status;\n    if (status === 401) return 'auth_error';\n    if (status === 403) return 'permission_error';\n    if (status === 422) return 'validation_error';\n    if (status === 429) return 'rate_limit';\n    if (status >= 500) return 'server_error';\n    if (error.code === 'ECONNREFUSED') return 'connection_error';\n    if (error.code === 'ETIMEDOUT') return 'timeout';\n    return 'unknown';\n  }\n}\n```\n\n## Structured Logging\n\n```typescript\n\u002F\u002F src\u002Flib\u002Fapollo\u002Flogger.ts\nimport pino from 'pino';\n\nconst logger = pino({\n  level: process.env.LOG_LEVEL || 'info',\n  formatters: {\n    level: (label) => ({ level: label }),\n  },\n  redact: {\n    paths: ['api_key', '*.email', '*.phone', 'headers.authorization'],\n    censor: '[REDACTED]',\n  },\n  base: {\n    service: 'apollo-integration',\n    environment: process.env.NODE_ENV,\n  },\n});\n\nexport const apolloLogger = logger.child({ component: 'apollo' });\n\n\u002F\u002F Request\u002Fresponse logging\nexport function logApolloRequest(context: {\n  endpoint: string;\n  method: string;\n  params?: object;\n  requestId: string;\n}): void {\n  apolloLogger.info({\n    type: 'apollo_request',\n    ...context,\n    timestamp: new Date().toISOString(),\n  });\n}\n\nexport function logApolloResponse(context: {\n  endpoint: string;\n  status: number;\n  durationMs: number;\n  requestId: string;\n  resultCount?: number;\n}): void {\n  apolloLogger.info({\n    type: 'apollo_response',\n    ...context,\n    timestamp: new Date().toISOString(),\n  });\n}\n\nexport function logApolloError(context: {\n  endpoint: string;\n  error: Error;\n  requestId: string;\n  retryCount?: number;\n}): void {\n  apolloLogger.error({\n    type: 'apollo_error',\n    endpoint: context.endpoint,\n    error: {\n      name: context.error.name,\n      message: context.error.message,\n      stack: context.error.stack,\n    },\n    requestId: context.requestId,\n    retryCount: context.retryCount,\n    timestamp: new Date().toISOString(),\n  });\n}\n```\n\n## Distributed Tracing (OpenTelemetry)\n\n```typescript\n\u002F\u002F src\u002Flib\u002Fapollo\u002Ftracing.ts\nimport { trace, Span, SpanStatusCode, context as otelContext } from '@opentelemetry\u002Fapi';\nimport { W3CTraceContextPropagator } from '@opentelemetry\u002Fcore';\n\nconst tracer = trace.getTracer('apollo-integration');\nconst propagator = new W3CTraceContextPropagator();\n\nexport function createApolloSpan(\n  name: string,\n  attributes: Record\u003Cstring, any>\n): Span {\n  return tracer.startSpan(`apollo.${name}`, {\n    attributes: {\n      'apollo.endpoint': attributes.endpoint,\n      'apollo.method': attributes.method,\n      'service.name': 'apollo-integration',\n    },\n  });\n}\n\nexport async function traceApolloRequest\u003CT>(\n  endpoint: string,\n  requestFn: () => Promise\u003CT>\n): Promise\u003CT> {\n  const span = createApolloSpan('request', { endpoint });\n\n  try {\n    const result = await otelContext.with(\n      trace.setSpan(otelContext.active(), span),\n      requestFn\n    );\n\n    span.setStatus({ code: SpanStatusCode.OK });\n    return result;\n  } catch (error: any) {\n    span.setStatus({\n      code: SpanStatusCode.ERROR,\n      message: error.message,\n    });\n    span.recordException(error);\n    throw error;\n  } finally {\n    span.end();\n  }\n}\n\n\u002F\u002F Middleware for Express\nexport function apolloTracingMiddleware(req: any, res: any, next: any) {\n  const span = createApolloSpan('http_request', {\n    endpoint: req.path,\n    method: req.method,\n  });\n\n  req.apolloSpan = span;\n\n  res.on('finish', () => {\n    span.setAttribute('http.status_code', res.statusCode);\n    span.end();\n  });\n\n  next();\n}\n```\n\n## Alerting Rules\n\n```yaml\n# prometheus\u002Fapollo-alerts.yml\ngroups:\n  - name: apollo-alerts\n    rules:\n      # High error rate\n      - alert: ApolloHighErrorRate\n        expr: |\n          sum(rate(apollo_errors_total[5m])) \u002F\n          sum(rate(apollo_requests_total[5m])) > 0.05\n        for: 5m\n        labels:\n          severity: warning\n        annotations:\n          summary: \"High Apollo API error rate\"\n          description: \"Apollo error rate is {{ $value | humanizePercentage }}\"\n\n      # Rate limit warnings\n      - alert: ApolloRateLimitApproaching\n        expr: apollo_rate_limit_remaining \u003C 20\n        for: 2m\n        labels:\n          severity: warning\n        annotations:\n          summary: \"Apollo rate limit approaching\"\n          description: \"Only {{ $value }} requests remaining\"\n\n      - alert: ApolloRateLimitHit\n        expr: increase(apollo_rate_limit_hits_total[5m]) > 0\n        labels:\n          severity: critical\n        annotations:\n          summary: \"Apollo rate limit hit\"\n          description: \"Rate limit was hit {{ $value }} times in last 5 minutes\"\n\n      # Latency alerts\n      - alert: ApolloHighLatency\n        expr: |\n          histogram_quantile(0.95, rate(apollo_request_duration_seconds_bucket[5m])) > 5\n        for: 5m\n        labels:\n          severity: warning\n        annotations:\n          summary: \"High Apollo API latency\"\n          description: \"P95 latency is {{ $value | humanizeDuration }}\"\n\n      # Credit usage\n      - alert: ApolloHighCreditUsage\n        expr: |\n          increase(apollo_credits_used_total[24h]) > 8000\n        labels:\n          severity: warning\n        annotations:\n          summary: \"High Apollo credit consumption\"\n          description: \"{{ $value }} credits used in last 24 hours\"\n```\n\n## Grafana Dashboard\n\n```json\n{\n  \"dashboard\": {\n    \"title\": \"Apollo.io Integration\",\n    \"panels\": [\n      {\n        \"title\": \"Request Rate\",\n        \"type\": \"graph\",\n        \"targets\": [\n          {\n            \"expr\": \"sum(rate(apollo_requests_total[5m])) by (endpoint)\",\n            \"legendFormat\": \"{{ endpoint }}\"\n          }\n        ]\n      },\n      {\n        \"title\": \"Error Rate\",\n        \"type\": \"graph\",\n        \"targets\": [\n          {\n            \"expr\": \"sum(rate(apollo_errors_total[5m])) by (error_type)\",\n            \"legendFormat\": \"{{ error_type }}\"\n          }\n        ]\n      },\n      {\n        \"title\": \"Request Duration (P95)\",\n        \"type\": \"graph\",\n        \"targets\": [\n          {\n            \"expr\": \"histogram_quantile(0.95, rate(apollo_request_duration_seconds_bucket[5m]))\",\n            \"legendFormat\": \"P95\"\n          }\n        ]\n      },\n      {\n        \"title\": \"Rate Limit Status\",\n        \"type\": \"gauge\",\n        \"targets\": [\n          {\n            \"expr\": \"apollo_rate_limit_remaining\",\n            \"legendFormat\": \"Remaining\"\n          }\n        ],\n        \"thresholds\": [\n          { \"value\": 0, \"color\": \"red\" },\n          { \"value\": 20, \"color\": \"yellow\" },\n          { \"value\": 50, \"color\": \"green\" }\n        ]\n      },\n      {\n        \"title\": \"Cache Hit Rate\",\n        \"type\": \"stat\",\n        \"targets\": [\n          {\n            \"expr\": \"sum(rate(apollo_cache_hits_total[5m])) \u002F (sum(rate(apollo_cache_hits_total[5m])) + sum(rate(apollo_cache_misses_total[5m])))\",\n            \"legendFormat\": \"Hit Rate\"\n          }\n        ]\n      },\n      {\n        \"title\": \"Credits Used Today\",\n        \"type\": \"stat\",\n        \"targets\": [\n          {\n            \"expr\": \"increase(apollo_credits_used_total[24h])\"\n          }\n        ]\n      }\n    ]\n  }\n}\n```\n\n## Health Check Endpoint\n\n```typescript\n\u002F\u002F src\u002Froutes\u002Fhealth\u002Fapollo.ts\nimport { Router } from 'express';\nimport { register } from '..\u002F..\u002Flib\u002Fapollo\u002Fmetrics';\n\nconst router = Router();\n\nrouter.get('\u002Fhealth\u002Fapollo', async (req, res) => {\n  const checks = {\n    api: false,\n    rateLimit: false,\n    cache: false,\n  };\n\n  try {\n    \u002F\u002F Check API connectivity\n    await apollo.healthCheck();\n    checks.api = true;\n\n    \u002F\u002F Check rate limit status\n    const remaining = apolloRateLimitRemaining.get();\n    checks.rateLimit = remaining > 10;\n\n    \u002F\u002F Check cache health\n    const cacheStats = apolloCache.getStats();\n    checks.cache = cacheStats.size > 0;\n\n    const healthy = Object.values(checks).every(Boolean);\n\n    res.status(healthy ? 200 : 503).json({\n      status: healthy ? 'healthy' : 'degraded',\n      checks,\n      timestamp: new Date().toISOString(),\n    });\n  } catch (error: any) {\n    res.status(503).json({\n      status: 'unhealthy',\n      error: error.message,\n      checks,\n    });\n  }\n});\n\nrouter.get('\u002Fmetrics', async (req, res) => {\n  res.set('Content-Type', register.contentType);\n  res.end(await register.metrics());\n});\n\nexport default router;\n```\n\n## Output\n- Prometheus metrics for all Apollo operations\n- Structured JSON logging with PII redaction\n- OpenTelemetry distributed tracing\n- Alerting rules for errors, rate limits, latency\n- Grafana dashboard configuration\n- Health check endpoints\n\n## Error Handling\n| Issue | Resolution |\n|-------|------------|\n| Missing metrics | Verify instrumentation |\n| Alert noise | Tune thresholds |\n| Log volume | Adjust log levels |\n| Trace gaps | Check propagation |\n\n## Resources\n- [Prometheus Documentation](https:\u002F\u002Fprometheus.io\u002Fdocs\u002F)\n- [OpenTelemetry](https:\u002F\u002Fopentelemetry.io\u002F)\n- [Grafana Dashboards](https:\u002F\u002Fgrafana.com\u002Fgrafana\u002Fdashboards\u002F)\n- [Pino Logger](https:\u002F\u002Fgetpino.io\u002F)\n\n## Next Steps\nProceed to `apollo-incident-runbook` for incident response.\n","# Apollo Observability\n\n## Overview\nComprehensive observability setup for Apollo.io integrations including metrics, logging, tracing, and alerting.\n\n## Metrics with Prometheus\n\n```typescript\n\u002F\u002F src\u002Flib\u002Fapollo\u002Fmetrics.ts\nimport { Registry, Counter, Histogram, Gauge } from 'prom-client';\n\nconst register = new Registry();\n\n\u002F\u002F Request metrics\nexport const apolloRequestsTotal = new Counter({\n  name: 'apollo_requests_total',\n  help: 'Total number of Apollo API requests',\n  labelNames: ['endpoint', 'method', 'status'],\n  registers: [register],\n});\n\nexport const apolloRequestDuration = new Histogram({\n  name: 'apollo_request_duration_seconds',\n  help: 'Duration of Apollo API requests in seconds',\n  labelNames: ['endpoint', 'method'],\n  buckets: [0.1, 0.25, 0.5, 1, 2.5, 5, 10],\n  registers: [register],\n});\n\n\u002F\u002F Rate limit metrics\nexport const apolloRateLimitRemaining = new Gauge({\n  name: 'apollo_rate_limit_remaining',\n  help: 'Remaining Apollo API rate limit',\n  labelNames: ['endpoint'],\n  registers: [register],\n});\n\nexport const apolloRateLimitHits = new Counter({\n  name: 'apollo_rate_limit_hits_total',\n  help: 'Number of times rate limit was hit',\n  registers: [register],\n});\n\n\u002F\u002F Cache metrics\nexport const apolloCacheHits = new Counter({\n  name: 'apollo_cache_hits_total',\n  help: 'Number of Apollo cache hits',\n  labelNames: ['endpoint'],\n  registers: [register],\n});\n\nexport const apolloCacheMisses = new Counter({\n  name: 'apollo_cache_misses_total',\n  help: 'Number of Apollo cache misses',\n  labelNames: ['endpoint'],\n  registers: [register],\n});\n\n\u002F\u002F Credit usage\nexport const apolloCreditsUsed = new Counter({\n  name: 'apollo_credits_used_total',\n  help: 'Total Apollo credits consumed',\n  labelNames: ['operation'],\n  registers: [register],\n});\n\n\u002F\u002F Error tracking\nexport const apolloErrors = new Counter({\n  name: 'apollo_errors_total',\n  help: 'Total Apollo API errors',\n  labelNames: ['endpoint', 'error_type'],\n  registers: [register],\n});\n\nexport { register };\n```\n\n### Instrumented Client\n\n```typescript\n\u002F\u002F src\u002Flib\u002Fapollo\u002Finstrumented-client.ts\nimport { apolloRequestsTotal, apolloRequestDuration, apolloErrors } from '.\u002Fmetrics';\n\nexport class InstrumentedApolloClient {\n  async request\u003CT>(endpoint: string, options: RequestOptions): Promise\u003CT> {\n    const labels = { endpoint, method: options.method || 'POST' };\n    const endTimer = apolloRequestDuration.startTimer(labels);\n\n    try {\n      const response = await this.baseClient.request(endpoint, options);\n\n      apolloRequestsTotal.inc({ ...labels, status: 'success' });\n\n      \u002F\u002F Track rate limit from headers\n      const remaining = response.headers['x-ratelimit-remaining'];\n      if (remaining) {\n        apolloRateLimitRemaining.set({ endpoint }, parseInt(remaining));\n      }\n\n      return response.data;\n    } catch (error: any) {\n      const errorType = this.classifyError(error);\n      apolloRequestsTotal.inc({ ...labels, status: 'error' });\n      apolloErrors.inc({ endpoint, error_type: errorType });\n\n      if (error.response?.status === 429) {\n        apolloRateLimitHits.inc();\n      }\n\n      throw error;\n    } finally {\n      endTimer();\n    }\n  }\n\n  private classifyError(error: any): string {\n    const status = error.response?.status;\n    if (status === 401) return 'auth_error';\n    if (status === 403) return 'permission_error';\n    if (status === 422) return 'validation_error';\n    if (status === 429) return 'rate_limit';\n    if (status >= 500) return 'server_error';\n    if (error.code === 'ECONNREFUSED') return 'connection_error';\n    if (error.code === 'ETIMEDOUT') return 'timeout';\n    return 'unknown';\n  }\n}\n```\n\n## Structured Logging\n\n```typescript\n\u002F\u002F src\u002Flib\u002Fapollo\u002Flogger.ts\nimport pino from 'pino';\n\nconst logger = pino({\n  level: process.env.LOG_LEVEL || 'info',\n  formatters: {\n    level: (label) => ({ level: label }),\n  },\n  redact: {\n    paths: ['api_key', '*.email', '*.phone', 'headers.authorization'],\n    censor: '[REDACTED]',\n  },\n  base: {\n    service: 'apollo-integration',\n    environment: process.env.NODE_ENV,\n  },\n});\n\nexport const apolloLogger = logger.child({ component: 'apollo' });\n\n\u002F\u002F Request\u002Fresponse logging\nexport function logApolloRequest(context: {\n  endpoint: string;\n  method: string;\n  params?: object;\n  requestId: string;\n}): void {\n  apolloLogger.info({\n    type: 'apollo_request',\n    ...context,\n    timestamp: new Date().toISOString(),\n  });\n}\n\nexport function logApolloResponse(context: {\n  endpoint: string;\n  status: number;\n  durationMs: number;\n  requestId: string;\n  resultCount?: number;\n}): void {\n  apolloLogger.info({\n    type: 'apollo_response',\n    ...context,\n    timestamp: new Date().toISOString(),\n  });\n}\n\nexport function logApolloError(context: {\n  endpoint: string;\n  error: Error;\n  requestId: string;\n  retryCount?: number;\n}): void {\n  apolloLogger.error({\n    type: 'apollo_error',\n    endpoint: context.endpoint,\n    error: {\n      name: context.error.name,\n      message: context.error.message,\n      stack: context.error.stack,\n    },\n    requestId: context.requestId,\n    retryCount: context.retryCount,\n    timestamp: new Date().toISOString(),\n  });\n}\n```\n\n## Distributed Tracing (OpenTelemetry)\n\n```typescript\n\u002F\u002F src\u002Flib\u002Fapollo\u002Ftracing.ts\nimport { trace, Span, SpanStatusCode, context as otelContext } from '@opentelemetry\u002Fapi';\nimport { W3CTraceContextPropagator } from '@opentelemetry\u002Fcore';\n\nconst tracer = trace.getTracer('apollo-integration');\nconst propagator = new W3CTraceContextPropagator();\n\nexport function createApolloSpan(\n  name: string,\n  attributes: Record\u003Cstring, any>\n): Span {\n  return tracer.startSpan(`apollo.${name}`, {\n    attributes: {\n      'apollo.endpoint': attributes.endpoint,\n      'apollo.method': attributes.method,\n      'service.name': 'apollo-integration',\n    },\n  });\n}\n\nexport async function traceApolloRequest\u003CT>(\n  endpoint: string,\n  requestFn: () => Promise\u003CT>\n): Promise\u003CT> {\n  const span = createApolloSpan('request', { endpoint });\n\n  try {\n    const result = await otelContext.with(\n      trace.setSpan(otelContext.active(), span),\n      requestFn\n    );\n\n    span.setStatus({ code: SpanStatusCode.OK });\n    return result;\n  } catch (error: any) {\n    span.setStatus({\n      code: SpanStatusCode.ERROR,\n      message: error.message,\n    });\n    span.recordException(error);\n    throw error;\n  } finally {\n    span.end();\n  }\n}\n\n\u002F\u002F Middleware for Express\nexport function apolloTracingMiddleware(req: any, res: any, next: any) {\n  const span = createApolloSpan('http_request', {\n    endpoint: req.path,\n    method: req.method,\n  });\n\n  req.apolloSpan = span;\n\n  res.on('finish', () => {\n    span.setAttribute('http.status_code', res.statusCode);\n    span.end();\n  });\n\n  next();\n}\n```\n\n## Alerting Rules\n\n```yaml\n# prometheus\u002Fapollo-alerts.yml\ngroups:\n  - name: apollo-alerts\n    rules:\n      # High error rate\n      - alert: ApolloHighErrorRate\n        expr: |\n          sum(rate(apollo_errors_total[5m])) \u002F\n          sum(rate(apollo_requests_total[5m])) > 0.05\n        for: 5m\n        labels:\n          severity: warning\n        annotations:\n          summary: \"High Apollo API error rate\"\n          description: \"Apollo error rate is {{ $value | humanizePercentage }}\"\n\n      # Rate limit warnings\n      - alert: ApolloRateLimitApproaching\n        expr: apollo_rate_limit_remaining \u003C 20\n        for: 2m\n        labels:\n          severity: warning\n        annotations:\n          summary: \"Apollo rate limit approaching\"\n          description: \"Only {{ $value }} requests remaining\"\n\n      - alert: ApolloRateLimitHit\n        expr: increase(apollo_rate_limit_hits_total[5m]) > 0\n        labels:\n          severity: critical\n        annotations:\n          summary: \"Apollo rate limit hit\"\n          description: \"Rate limit was hit {{ $value }} times in last 5 minutes\"\n\n      # Latency alerts\n      - alert: ApolloHighLatency\n        expr: |\n          histogram_quantile(0.95, rate(apollo_request_duration_seconds_bucket[5m])) > 5\n        for: 5m\n        labels:\n          severity: warning\n        annotations:\n          summary: \"High Apollo API latency\"\n          description: \"P95 latency is {{ $value | humanizeDuration }}\"\n\n      # Credit usage\n      - alert: ApolloHighCreditUsage\n        expr: |\n          increase(apollo_credits_used_total[24h]) > 8000\n        labels:\n          severity: warning\n        annotations:\n          summary: \"High Apollo credit consumption\"\n          description: \"{{ $value }} credits used in last 24 hours\"\n```\n\n## Grafana Dashboard\n\n```json\n{\n  \"dashboard\": {\n    \"title\": \"Apollo.io Integration\",\n    \"panels\": [\n      {\n        \"title\": \"Request Rate\",\n        \"type\": \"graph\",\n        \"targets\": [\n          {\n            \"expr\": \"sum(rate(apollo_requests_total[5m])) by (endpoint)\",\n            \"legendFormat\": \"{{ endpoint }}\"\n          }\n        ]\n      },\n      {\n        \"title\": \"Error Rate\",\n        \"type\": \"graph\",\n        \"targets\": [\n          {\n            \"expr\": \"sum(rate(apollo_errors_total[5m])) by (error_type)\",\n            \"legendFormat\": \"{{ error_type }}\"\n          }\n        ]\n      },\n      {\n        \"title\": \"Request Duration (P95)\",\n        \"type\": \"graph\",\n        \"targets\": [\n          {\n            \"expr\": \"histogram_quantile(0.95, rate(apollo_request_duration_seconds_bucket[5m]))\",\n            \"legendFormat\": \"P95\"\n          }\n        ]\n      },\n      {\n        \"title\": \"Rate Limit Status\",\n        \"type\": \"gauge\",\n        \"targets\": [\n          {\n            \"expr\": \"apollo_rate_limit_remaining\",\n            \"legendFormat\": \"Remaining\"\n          }\n        ],\n        \"thresholds\": [\n          { \"value\": 0, \"color\": \"red\" },\n          { \"value\": 20, \"color\": \"yellow\" },\n          { \"value\": 50, \"color\": \"green\" }\n        ]\n      },\n      {\n        \"title\": \"Cache Hit Rate\",\n        \"type\": \"stat\",\n        \"targets\": [\n          {\n            \"expr\": \"sum(rate(apollo_cache_hits_total[5m])) \u002F (sum(rate(apollo_cache_hits_total[5m])) + sum(rate(apollo_cache_misses_total[5m])))\",\n            \"legendFormat\": \"Hit Rate\"\n          }\n        ]\n      },\n      {\n        \"title\": \"Credits Used Today\",\n        \"type\": \"stat\",\n        \"targets\": [\n          {\n            \"expr\": \"increase(apollo_credits_used_total[24h])\"\n          }\n        ]\n      }\n    ]\n  }\n}\n```\n\n## Health Check Endpoint\n\n```typescript\n\u002F\u002F src\u002Froutes\u002Fhealth\u002Fapollo.ts\nimport { Router } from 'express';\nimport { register } from '..\u002F..\u002Flib\u002Fapollo\u002Fmetrics';\n\nconst router = Router();\n\nrouter.get('\u002Fhealth\u002Fapollo', async (req, res) => {\n  const checks = {\n    api: false,\n    rateLimit: false,\n    cache: false,\n  };\n\n  try {\n    \u002F\u002F Check API connectivity\n    await apollo.healthCheck();\n    checks.api = true;\n\n    \u002F\u002F Check rate limit status\n    const remaining = apolloRateLimitRemaining.get();\n    checks.rateLimit = remaining > 10;\n\n    \u002F\u002F Check cache health\n    const cacheStats = apolloCache.getStats();\n    checks.cache = cacheStats.size > 0;\n\n    const healthy = Object.values(checks).every(Boolean);\n\n    res.status(healthy ? 200 : 503).json({\n      status: healthy ? 'healthy' : 'degraded',\n      checks,\n      timestamp: new Date().toISOString(),\n    });\n  } catch (error: any) {\n    res.status(503).json({\n      status: 'unhealthy',\n      error: error.message,\n      checks,\n    });\n  }\n});\n\nrouter.get('\u002Fmetrics', async (req, res) => {\n  res.set('Content-Type', register.contentType);\n  res.end(await register.metrics());\n});\n\nexport default router;\n```\n\n## Output\n- Prometheus metrics for all Apollo operations\n- Structured JSON logging with PII redaction\n- OpenTelemetry distributed tracing\n- Alerting rules for errors, rate limits, latency\n- Grafana dashboard configuration\n- Health check endpoints\n\n## Error Handling\n| Issue | Resolution |\n|-------|------------|\n| Missing metrics | Verify instrumentation |\n| Alert noise | Tune thresholds |\n| Log volume | Adjust log levels |\n| Trace gaps | Check propagation |\n\n## Resources\n- [Prometheus Documentation](https:\u002F\u002Fprometheus.io\u002Fdocs\u002F)\n- [OpenTelemetry](https:\u002F\u002Fopentelemetry.io\u002F)\n- [Grafana Dashboards](https:\u002F\u002Fgrafana.com\u002Fgrafana\u002Fdashboards\u002F)\n- [Pino Logger](https:\u002F\u002Fgetpino.io\u002F)\n\n## Next Steps\nProceed to `apollo-incident-runbook` for incident response.\n",{"name":5,"author":46,"license":15,"version":47,"description":48,"allowed-tools":49},"Jeremy Longshore \u003Cjeremy@intentsolutions.io>","1.0.0","Set up Apollo.io monitoring and observability.\nUse when implementing logging, metrics, tracing, and alerting\nfor Apollo integrations.\nTrigger with phrases like \"apollo monitoring\", \"apollo metrics\",\n\"apollo observability\", \"apollo logging\", \"apollo alerts\".\n","Read, Write, Edit, Bash(kubectl:*), Bash(curl:*)","main","7439377908fdee98c9bb5863391212b95453de95","tests\u002Fext_conformance\u002Fartifacts\u002Fplugins-community\u002Fplugins\u002Fsaas-packs\u002Fapollo-pack\u002Fskills\u002Fapollo-observability",233,"https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust","https:\u002F\u002Fgithub.com\u002FDicklesworthstone","https:\u002F\u002Fwww.jeffreyemanuel.com\u002F","Building in NY","2026-11-15 01:54:15",{"source":8,"skillName":5,"commands":60,"prompt":70,"zipAvailable":71},[61,64,67],{"tool":62,"command":63},"npx","npx skills add Dicklesworthstone\u002Fpi_agent_rust --skill apollo-observability",{"tool":65,"command":66},"bunx","bunx skills add Dicklesworthstone\u002Fpi_agent_rust --skill apollo-observability",{"tool":68,"command":69},"pnpm","pnpm dlx skills add Dicklesworthstone\u002Fpi_agent_rust --skill apollo-observability","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Fplugins-community\u002Fplugins\u002Fsaas-packs\u002Fapollo-pack\u002Fskills\u002Fapollo-observability\u002FSKILL.md",true,[73,78,84],{"path":74,"resourceType":74,"resourceTypeDesc":75,"sizeBytes":76,"sourceHtmlUrl":77},"LICENSE","许可证",1071,"https:\u002F\u002Fgithub.com\u002Fjiayaoqijia\u002Fcryptoskill\u002Fblob\u002Fmain\u002Fskills\u002Fmcp-servers\u002Fdanthamanvoiss-salesportl-print-sales-conversion-playbook\u002FLICENSE",{"path":79,"resourceType":80,"resourceTypeDesc":81,"sizeBytes":82,"sourceHtmlUrl":83},"SOURCE.md","REFERENCE","参考文档",487,"https:\u002F\u002Fgithub.com\u002Fjiayaoqijia\u002Fcryptoskill\u002Fblob\u002Fmain\u002Fskills\u002Fmcp-servers\u002Fdanthamanvoiss-salesportl-print-sales-conversion-playbook\u002FSOURCE.md",{"path":85,"resourceType":80,"resourceTypeDesc":81,"sizeBytes":86,"sourceHtmlUrl":87},"TRUST.auto.yaml",2217,"https:\u002F\u002Fgithub.com\u002Fjiayaoqijia\u002Fcryptoskill\u002Fblob\u002Fmain\u002Fskills\u002Fmcp-servers\u002Fdanthamanvoiss-salesportl-print-sales-conversion-playbook\u002FTRUST.auto.yaml",[89,122,157,180,205,231],{"skillNo":90,"name":91,"nameZh":6,"description":92,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":93,"licenseFileUrl":94,"sourceHtmlUrl":95,"categories":96,"keywords":102,"publishedAt":121},"01M6FCR7G5A005P364Z6ZWCJDP","theme-factory","Toolkit for styling artifacts with a theme. These artifacts can be slides, docs, reportings, HTML landing pages, etc. There are 10 pre-set themes with colors\u002Ffonts that you can apply to any artifact that has been creating, or can generate a new theme on-the-fly.","Apache-2.0","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fcreative-design\u002Ftheme-factory\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fcreative-design\u002Ftheme-factory\u002FSKILL.md",[97],{"categoryNo":98,"categoryName":99,"taxonomyType":100,"taxonomyTypeDesc":101},"01JBSEEDCAT000000000000015","视觉设计","SCENARIO","使用场景",[103,104,105,106,107,108,109,35,110,111,112,113,114,115,116,117,118,119,120],"theme factory","factory","theme","docs","toolkit","generate","artifacts","fly","slides","landing","html","styling","artifact","pages","themes","with","you","fonts","2026-11-11 15:11:14",{"skillNo":123,"name":124,"nameZh":6,"description":125,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":93,"licenseFileUrl":126,"sourceHtmlUrl":127,"categories":128,"keywords":132,"publishedAt":41},"01M6FEGPPK0ZTKCCM0R3E3KS33","web-artifacts-builder","Suite of tools for creating elaborate, multi-component claude.ai HTML artifacts using modern frontend web technologies (React, Tailwind CSS, shadcn\u002Fui). Use for complex artifacts requiring state management, routing, or shadcn\u002Fui components - not for simple single-file HTML\u002FJSX artifacts.","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Futilities\u002Fweb-artifacts-builder\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Futilities\u002Fweb-artifacts-builder\u002FSKILL.md",[129],{"categoryNo":130,"categoryName":131,"taxonomyType":100,"taxonomyTypeDesc":101},"01JBSEEDCAT000000000000009","前端开发",[133,134,109,135,136,137,138,139,140,141,142,143,144,145,146,147,148,149,28,113,150,151,152,153,154,155,156],"web artifacts builder","web","artifacts builder","builder","frontend","css","components","react","component","routing","state management","state","shadcn","file","ui","Tools","Tailwind","single-file","simple","ui components","multi","for","jsx","suite",{"skillNo":158,"name":159,"nameZh":6,"description":160,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":93,"licenseFileUrl":161,"sourceHtmlUrl":162,"categories":163,"keywords":168,"publishedAt":41},"01M6FEE9VTK1W4GY21AKREJXRG","webapp-testing","Toolkit for interacting with and testing local web applications using Playwright. Supports verifying frontend functionality, debugging UI behavior, capturing browser screenshots, and viewing browser logs.","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fsecurity\u002Fwebapp-testing\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fsecurity\u002Fwebapp-testing\u002FSKILL.md",[164,167],{"categoryNo":165,"categoryName":166,"taxonomyType":100,"taxonomyTypeDesc":101},"01JBSEEDCAT000000000000008","测试与质量",{"categoryNo":130,"categoryName":131,"taxonomyType":100,"taxonomyTypeDesc":101},[169,170,171,137,172,173,134,174,107,175,147,176,177,178,179,118,154],"testing","webapp testing","webapp","screenshots","playwright","debugging","browser","logs","applications","behavior","local",{"skillNo":181,"name":182,"nameZh":6,"description":183,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":184,"sourceHtmlUrl":185,"categories":186,"keywords":187,"publishedAt":41},"01M6FE20F7ZTQBFWKF4MPJ2SBX","neuropixels-analysis","Neuropixels neural recording analysis. Load SpikeGLX\u002FOpenEphys data, preprocess, motion correction, Kilosort4 spike sorting, quality metrics, Allen\u002FIBL curation, AI-assisted visual analysis, for Neuropixels 1.0\u002F2.0 extracellular electrophysiology. Use when working with neural recordings, spike sorting, extracellular electrophysiology, or when the user mentions Neuropixels, SpikeGLX, Open Ephys, Kilosort, quality metrics, or unit curation.","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fscientific\u002Fneuropixels-analysis\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fscientific\u002Fneuropixels-analysis\u002FSKILL.md",[],[188,189,190,40,191,192,193,194,28,195,196,197,198,199,200,201,118,202,203,204,154,23],"analysis","neuropixels analysis","spike","data","open","quality","user","recordings","Neural","motion","visual","quality metrics","unit","sorting","curation","recording","load",{"skillNo":206,"name":207,"nameZh":6,"description":208,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":93,"licenseFileUrl":209,"sourceHtmlUrl":210,"categories":211,"keywords":215,"publishedAt":41},"01M6FDP0PDK6F1GGX395C7625Z","skill-creator","Guide for creating effective skills. This skill should be used when users want to create a new skill (or update an existing skill) that extends Claude's capabilities with specialized knowledge, workflows, or tool integrations.","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fproductivity\u002Fskill-creator\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fproductivity\u002Fskill-creator\u002FSKILL.md",[212],{"categoryNo":213,"categoryName":214,"taxonomyType":100,"taxonomyTypeDesc":101},"01JBSEEDCAT000000000000023","Skill与智能体开发",[216,217,218,219,220,221,222,223,33,224,225,226,227,228,118,154,229,23,230],"skill creator","creator","workflows","create","update","capabilities","knowledge","tool","specialized","guide","new skill","existing skill","users","Existing","new",{"skillNo":232,"name":233,"nameZh":6,"description":234,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":235,"sourceHtmlUrl":236,"categories":237,"keywords":239,"publishedAt":41},"01M6FDM8Y7VK7NYG9SM7QPA3PW","notebooklm","Use this skill to query your Google NotebookLM notebooks directly from Claude Code for source-grounded, citation-backed answers from Gemini. Browser automation, library management, persistent auth. Drastically reduced hallucinations through document-only responses.","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fproductivity\u002Fnotebooklm\u002FLICENSE","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fproductivity\u002Fnotebooklm\u002FSKILL.md",[238],{"categoryNo":213,"categoryName":214,"taxonomyType":100,"taxonomyTypeDesc":101},[233,240,241,242,243,244,245,175,246,247,28,248,249,250,251,154,252],"google","browser automation","gemini","automation","auth","code","library","management","only","document","query","Citation","source"]