Monitoring

Comprehensive logging and monitoring are essential for maintaining reliable services. ShipOS provides detailed API logs, performance metrics, and alerting to keep your application running smoothly and users satisfied.

The logging system captures every API request and response with detailed metadata including response times, status codes, user agents, and geographic locations. This data helps identify performance bottlenecks, security issues, and usage patterns across your application.

Accessing logs and performance data programmatically:

const logs = await shipos.logs.query({
  timeRange: '24h',
  endpoint: '/api/auth/login',
  statusCode: [400, 401, 403]
});

const metrics = await shipos.analytics.getMetrics({
  metric: 'response_time',
  timeRange: '7d'
});

const logs = await shipos.logs.query({
  timeRange: '24h',
  endpoint: '/api/auth/login',
  statusCode: [400, 401, 403]
});

const metrics = await shipos.analytics.getMetrics({
  metric: 'response_time',
  timeRange: '7d'
});

const logs = await shipos.logs.query({
  timeRange: '24h',
  endpoint: '/api/auth/login',
  statusCode: [400, 401, 403]
});

const metrics = await shipos.analytics.getMetrics({
  metric: 'response_time',
  timeRange: '7d'
});

Real-time monitoring tracks key performance indicators including response times, error rates, and throughput. The system automatically detects anomalies and can trigger alerts when thresholds are exceeded, enabling proactive issue resolution before users are affected.

The log search interface supports advanced filtering and querying. Search by user ID, IP address, endpoint, status code, or custom parameters. Export logs for external analysis or compliance requirements with popular formats like JSON and CSV.

Error tracking automatically groups similar errors and provides stack traces where available. This helps identify and resolve issues quickly while tracking error frequency to detect when new error types emerge, indicating potential system problems or integration issues.