Angular Application Logging Integration

LogTide’s Angular SDK provides a custom ErrorHandler for automatic error capture, an HttpInterceptor for distributed tracing, and providers for both standalone and NgModule-based applications.

Why use LogTide with Angular?

• Automatic error capture: Custom ErrorHandler catches all uncaught errors
• HTTP tracing: HttpInterceptor adds traceparent headers to outgoing requests
• Zone context: Errors are tagged with whether they happened inside or outside NgZone
• Single setup: provideLogtide() registers everything in one call
• Both styles: Supports standalone and NgModule-based apps

Prerequisites

• Angular 17+ (standalone or NgModule)
• LogTide instance with a DSN

Installation

npm install @logtide/angular

Standalone Setup (Angular 17+)

// main.ts
import { bootstrapApplication } from '@angular/platform-browser';
import { provideHttpClient, withInterceptorsFromDi } from '@angular/common/http';
import { provideLogtide } from '@logtide/angular';
import { AppComponent } from './app/app.component';

bootstrapApplication(AppComponent, {
  providers: [
    // required so the class-based LogtideHttpInterceptor is picked up
    provideHttpClient(withInterceptorsFromDi()),
    provideLogtide({
      dsn: 'https://[email protected]',
      service: 'angular-app',
      environment: 'production',
      release: '1.0.0',
    }),
  ],
});

NgModule Setup

// app.module.ts
import { NgModule } from '@angular/core';
import { getLogtideProviders } from '@logtide/angular';

@NgModule({
  providers: [
    ...getLogtideProviders({
      dsn: 'https://[email protected]',
      service: 'angular-app',
      environment: 'production',
    }),
  ],
  bootstrap: [AppComponent],
})
export class AppModule {}

Automatic Error Capture

Uncaught errors in components, services, and templates are captured automatically:

@Component({ selector: 'app-dashboard', template: '...' })
export class DashboardComponent implements OnInit {
  ngOnInit() {
    // If this throws, LogTide captures it via the custom ErrorHandler,
    // tagged with the mechanism and whether it ran inside NgZone
    this.loadData();
  }
}

HTTP Interceptor

Outgoing HttpClient requests automatically include tracing (a traceparent header, a span and breadcrumbs per request):

@Injectable()
export class UserService {
  constructor(private http: HttpClient) {}

  getUser(id: string) {
    // traceparent header added automatically
    // Failed requests captured as errors
    return this.http.get<User>(`/api/users/${id}`);
  }
}

Manual Logging in Components

import { hub } from '@logtide/core';

@Component({ selector: 'app-checkout', template: '...' })
export class CheckoutComponent {
  purchase() {
    hub.addBreadcrumb({
      type: 'ui',
      category: 'ui',
      message: 'Purchase button clicked',
      timestamp: Date.now(),
    });

    try {
      // process purchase...
      hub.captureLog('info', 'Purchase completed', { orderId: '123' });
    } catch (error) {
      hub.captureError(error, {
        tags: { module: 'checkout' },
      });
    }
  }
}

Next Steps

• JavaScript SDK - Core SDK reference
• Angular SDK Reference - Full API documentation
• Docker Integration - Container deployments