navan-observability

Featured

Use when setting up monitoring, logging, and alerting for Navan API integrations in production environments. Trigger with "navan observability" or "navan monitoring" or "navan api dashboards".

AI & Automation 2,926 stars 433 forks Updated yesterday MIT

Install

View on GitHub

Quality Score: 99/100

Stars 20%
100
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# Navan Observability ## Overview Navan exposes no built-in API metrics dashboard — monitoring is your responsibility. This skill implements structured logging, latency tracking, error classification, and alerting for Navan REST API integrations. Since Navan uses OAuth 2.0 with token expiration, observability must also cover the authentication lifecycle. Patterns are provided for Datadog, CloudWatch, and Prometheus/Grafana. ## Prerequisites - **Running Navan API integration** with OAuth 2.0 credentials - **Monitoring platform** — Datadog, AWS CloudWatch, or Prometheus/Grafana - **Node.js 18+** or equivalent runtime for the instrumentation middleware - API base URL: `https://api.navan.com/v1` ## Instructions ### Step 1 — Instrument API Calls with Structured Logging Wrap every Navan API call with timing, status, and correlation tracking: ```typescript import { randomUUID } from 'crypto'; interface NavanApiLog { event: 'navan.api.request'; correlation_id: string; method: string; endpoint: string; status: number; duration_ms: number; error_type?: 'auth' | 'rate_limit' | 'server' | 'client' | 'network'; timestamp: string; } async function navanRequest( method: string, endpoint: string, token: string, body?: object ): Promise<Response> { const correlationId = randomUUID(); const start = performance.now(); try { const response = await fetch(`https://api.navan.com/v1/${endpoint}`, { method, headers: { 'Authorization': `...

Details

Author
jeremylongshore
Repository
jeremylongshore/claude-code-plugins-plus-skills
Created
1 years ago
Last Updated
yesterday
Language
Python
License
MIT

Integrates with

Bundled in these plugins

Similar Skills

Semantically similar based on skill content — not just same category