lokalise-observability

name	lokalise-observability
description	Set up comprehensive observability for Lokalise integrations with metrics, traces, and alerts. Use when implementing monitoring for Lokalise operations, setting up dashboards, or configuring alerting for Lokalise integration health. Trigger with phrases like "lokalise monitoring", "lokalise metrics", "lokalise observability", "monitor lokalise", "lokalise alerts", "lokalise tracing".
allowed-tools	Read, Write, Edit, Bash(curl:*), Bash(jq:*), Bash(npm:*)
version	1.14.0
license	MIT
author	Jeremy Longshore <[e-mail]>
tags	["saas","lokalise","monitoring","observability","dashboard"]
compatibility	Designed for Claude Code

Lokalise Observability

Overview

Monitor Lokalise translation pipeline health: API response times, rate limit consumption, translation completion rates, webhook delivery reliability, file upload/download status, and per-word cost tracking. Built around the @lokalise/node-api SDK with Prometheus-compatible metrics and alerting rules.

Prerequisites

• @lokalise/node-api SDK installed
• Metrics backend (Prometheus, Datadog, CloudWatch, or OpenTelemetry collector)
• Lokalise API token with read access
• Optional: webhook endpoint for real-time event monitoring

Instructions

Step 1: Instrument API Calls with Metrics

Wrap every SDK call to emit duration, success/failure counts, and rate limit status.

import { LokaliseApi } from "@lokalise/node-api";

interface MetricLabels {
  operation: string;
  status: "ok" | "error";
  code?: string;
}

// Implement this to emit to your metrics backend
declare function emitHistogram(name: string, value: number, labels: MetricLabels): void;
declare function emitCounter(name: string, value: number, labels: MetricLabels): void;

const lok = new ({ : process..! });

  trackedApiCall<T>(
  : ,
  :  <T>
): <T> {
   start = performance.();
   {
     result =  ();
     durationMs = performance.() - start;

    (, durationMs, {
      operation,
      : ,
    });
    (, , {
      operation,
      : ,
    });

     result;
  }  (: ) {
     code = (err  { ?:  })?.?.() ?? ;
     durationMs = performance.() - start;

    (, durationMs, {
      operation,
      : ,
      code,
    });
    (, , {
      operation,
      : ,
      code,
    });

     err;
  }
}


 keys =  (, 
  lok.().({ : projectId, :  })
);

 bundle =  (, 
  lok.().(projectId, {
    : ,
    : [],
    : ,
  })
);