Log Explorer

Search, filter, and analyze your application logs in real time.

Overview#

The Log Explorer provides a centralized view of all logs from your applications. Logs are automatically correlated with traces and errors, giving you full context when debugging issues.

| Filter | Example | Description | |--------|---------|-------------| | level: | level:error | Log level (debug, info, warn, error, fatal) | | service: | service:api-server | Service that emitted the log | | trace: | trace:abc123 | Trace ID for correlation | | env: | env:production | Environment |

Combine filters:

level:error service:payment-service env:production

Log Levels#

| Level | Usage | Color | |-------|-------|-------| | debug | Verbose debugging info | Gray | | info | Normal operational messages | Blue | | warn | Potential issues | Yellow | | error | Error conditions | Red | | fatal | Critical failures | Dark Red |

Trace Correlation#

Every log emitted within a traced context automatically includes the trace ID and span ID. Click on a log entry to jump directly to the associated trace waterfall view.

import JA from '@justanalyticsapp/node';

JA.startSpan('process-order', async (span) => {
  // This log automatically includes the trace ID
  JA.logger.info('Processing order', { orderId: '123', total: 49.99 });

  const result = await processPayment();

  JA.logger.info('Payment processed', { transactionId: result.id });
  return result;
});

Live Tail#

Enable live tail to stream logs in real time. New logs appear at the bottom of the view as they arrive. This is useful for:

Watching logs during a deployment
Debugging issues in real time
Monitoring specific services during load tests

Log Retention#

| Plan | Retention Period | |------|-----------------| | Free | 3 days | | Pro | 30 days | | Business | 90 days |

Older logs are automatically archived and can be exported before deletion.

Exporting Logs#

Export logs as JSON or CSV for offline analysis. Use the export button in the top-right corner of the Log Explorer, or use the API:

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://justanalytics.app/api/ingest/logs/export?service=api-server&level=error&from=2024-01-01"