Skip to main content

Link Tracker

Welcome to the Link Tracker API Reference. This service provides centralized activity logging and event monitoring capabilities for the LedgerLink ecosystem.

Base URL: https://api.ledgerlink.ai/v1

Overview​

Link Tracker is a microservice that captures, stores, and retrieves system-wide activity logs and events from all LedgerLink services. It provides a centralized location for monitoring operations, debugging issues, and maintaining comprehensive audit trails across the platform.

Technology Stack:

  • NestJS backend with TypeScript
  • MongoDB for log storage
  • ActiveMQ/STOMP for real-time message streaming
  • RESTful API with Swagger documentation

Core Capabilities​

  • Centralized Logging: Capture and store detailed activity logs from all LedgerLink services
  • Event Tracking: Monitor over 50 different event types across transactions, participants, accounts, and system operations
  • Advanced Filtering: Query logs by service, request ID, date range, event type, and status
  • Real-time Streaming: Publish log messages via ActiveMQ/STOMP for real-time monitoring
  • Pagination & Sorting: Efficient retrieval of large log datasets with flexible sorting
  • MongoDB Storage: Fast, scalable document-based storage for log data

API Endpoints​

Log Message Operations​

Message Pattern (Internal)​

  • add_log_message - Message pattern for receiving logs from other services via ActiveMQ

Authentication​

Link Tracker is accessed through the Link Dashboard, which handles all authentication via the Auth Server (BFF).

Architecture:

User → Link Dashboard → Auth Server/BFF (Authentication) → Link Tracker Service

How It Works:

  • Users authenticate with the Link Dashboard (username/password)
  • The Auth Server validates JWT tokens and session cookies
  • Authenticated requests are proxied to Link Tracker at /api/activity-logs
  • No role-based access control (RBAC) - all authenticated users have full access
  • Link Tracker service itself does not implement authentication middleware
  • Service-to-service calls via ActiveMQ are unauthenticated (internal messaging)

See the Getting Started Guide for integration details.

Supported Event Types​

Link Tracker monitors 50+ event types across the platform:

Transaction Events: TRANSACTION_RECEIVED, TRANSACTION_STATUS_CHANGED, TRANSACTION_VALUED, TRANSACTION_BLOCKED, etc.

Participant Events: PARTICIPANT_CREATED, PARTICIPANT_DELETED, PARTICIPANT_NOT_FOUND

Account Events: ACCOUNT_CREATED, ACCOUNT_BALANCE_INQUIRY_SUCCESS, OMNIBUS_ACCOUNT_CREATED

System Events: APPLICATION_STARTED, APPLICATION_STOPPED, APPLICATION_READY

Valuation Events: VALUATION_REQUESTED, VALUATION_PROCESSED

See the complete event type list in the API reference.

Next Steps​

Need help? Contact our support team for assistance with your Link Tracker integration.