> ## Documentation Index
> Fetch the complete documentation index at: https://docs.truthlocks.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Salud y preparación

> Monitoreo del estado de la API, endpoints de preparación y página de estado.

Supervise el estado de la API de Truthlocks, verifique la preparación de las dependencias e intégrelo con su pila de observabilidad.

## Puntos de conexión de estado

### Sonda de actividad

Compruebe si la API está en funcionamiento. Úselo para las sondas de actividad de Kubernetes:

```http theme={null}
GET https://api.truthlocks.com/health/live

# Response (200 OK)
{
  "status": "ok",
  "timestamp": "2026-01-13T12:00:00Z"
}
```

### Sonda de preparación

Compruebe si la API está lista para atender el tráfico (todas las dependencias en buen estado):

```http theme={null}
GET https://api.truthlocks.com/health/ready

# Response (200 OK - All systems operational)
{
  "status": "ok",
  "timestamp": "2026-01-13T12:00:00Z",
  "checks": {
    "database": "ok",
    "redis": "ok",
    "signing_service": "ok",
    "transparency_log": "ok"
  }
}
```

```http theme={null}
# Response (503 Service Unavailable - Degraded)
{
  "status": "degraded",
  "timestamp": "2026-01-13T12:00:00Z",
  "checks": {
    "database": "ok",
    "redis": "timeout",
    "signing_service": "ok",
    "transparency_log": "ok"
  }
}
```

## Configuración de Kubernetes

Si está creando aplicaciones que dependen de Truthlocks, configure sus sondas para verificar tanto su aplicación como la API de Truthlocks:

```yaml theme={null}
apiVersion: v1
kind: Deployment
metadata:
  name: my-app
spec:
  template:
    spec:
      containers:
        - name: app
          livenessProbe:
            httpGet:
              path: /health/live
              port: 8080
            initialDelaySeconds: 5
            periodSeconds: 10
          readinessProbe:
            httpGet:
              path: /health/ready
              port: 8080
            initialDelaySeconds: 10
            periodSeconds: 5
            failureThreshold: 3
```

### Ejemplo de comprobación de preparación (aplicación)

```javascript theme={null}
// Include Truthlocks health in your app's readiness
app.get('/health/ready', async (req, res) => {
  const checks = {
    database: await checkDatabase(),
    truthlock: await checkTruthlock(),
  };

  const allHealthy = Object.values(checks).every(c => c === 'ok');

  res.status(allHealthy ? 200 : 503).json({
    status: allHealthy ? 'ok' : 'degraded',
    checks,
  });
});

async function checkTruthlock(): Promise<string> {
  try {
    const res = await fetch('https://api.truthlocks.com/health/ready', {
      timeout: 5000,
    });
    return res.ok ? 'ok' : 'degraded';
  } catch {
    return 'unreachable';
  }
}
```

## Página de estado

Verifique el estado y el tiempo de actividad del servicio en tiempo real en [status.truthlocks.com](https://status.truthlocks.com). La página de estado se actualiza automáticamente cada 60 segundos y no requiere autenticación.

### Servicios monitoreados

La página de estado rastrea la salud de cada servicio central de forma independiente:

| Servicio | Descripción |
| - | - |
| API Gateway | Punto final principal de la API para todas las solicitudes |
| Registro de confianza | Gestión y gobernanza de emisores |
| Facturación | Procesamiento de suscripciones y pagos |
| Firma | Operaciones de firma criptográfica |
| Atestaciones | Acuñación y gestión de atestaciones |
| Registros de auditoría | Registro de actividad y cumplimiento |
| Registro de transparencia | Registro criptográfico de solo anexar |
| Verificación | Verificación de paquete de prueba |
| Identidad de Máquina | Registro de agentes, sesiones y puntuación de confianza |
| CMO de IA | Moderación y orquestación de contenido de IA |

Cada servicio informa uno de cuatro estados: **operacional**, **degradado**, **interrupción** o **desconocido**. La página muestra un tiempo de respuesta por servicio y un banner general de estado del sistema.

### Historial de tiempo de actividad

Una barra de tiempo de actividad de 90 días muestra la disponibilidad diaria de cada servicio. Pase el cursor sobre cualquier día para ver la fecha y el porcentaje de tiempo de actividad. Se muestra un porcentaje general de tiempo de actividad junto a cada servicio.

### Historial de incidentes

Visite la página de **Historial de incidentes** para ver incidentes pasados en formato de línea de tiempo. Cada entrada incluye el nivel de gravedad, los servicios afectados y las actualizaciones con marca de tiempo desde la investigación hasta la resolución.

### Suscribirse a notificaciones

Ingrese su correo electrónico en la parte inferior de la página de estado para recibir notificaciones de incidentes. Se le notificará cuando se creen, actualicen o resuelvan incidentes.

Los clientes empresariales también pueden configurar devoluciones de llamada de webhook para recibir eventos de cambio de estado automáticamente.

### API de estado programático

Consultar la API de estado para conocer el estado del servicio legible por máquina. Utilice esto para integrar la disponibilidad de Truthlocks en sus propios paneles, tuberías de alerta o comprobaciones previas al vuelo. No se requiere autenticación.

```http theme={null}
GET https://status.truthlocks.com/api/health
```

El endpoint devuelve el estado general del sistema, una marca de tiempo y una matriz de comprobaciones de estado por servicio:

```json theme={null}
{
  "status": "operational",
  "timestamp": "2026-03-26T14:30:00Z",
  "services": [
    {
      "id": "api-gateway",
      "name": "API Gateway",
      "status": "operational",
      "responseTime": 42
    },
    {
      "id": "signing-service",
      "name": "Signing",
      "status": "degraded",
      "responseTime": 1200,
      "error": "HTTP 503"
    }
  ]
}
```

**Campos de respuesta:**

| Campo | Tipo | Descripción |
| - | - | - |
| `status` | string | Estado general del sistema: `operational`, `degraded`, o `outage`. |
| `timestamp` | string | Marca de tiempo ISO 8601 de la verificación. |
| `services` | array | Resultados de salud por servicio. |
| `services[].id` | string | Identificador de servicio legible por máquina (por ejemplo, `api-gateway`, `signing-service`). |
| `services[].name` | string | Nombre del servicio legible. |
| `services[].status` | string | Estado del servicio: `operational`, `degraded`, o `outage`. |
| `services[].responseTime` | number or null | Tiempo de respuesta en milisegundos, o `null` si es inalcanzable. |
| `services[].error` | string | Presente solo cuando el servicio no está operativo. |

El estado general es `outage` si algún servicio está inactivo, `degraded` si algún servicio es lento o devuelve errores, y `operational` cuando todos los servicios están en buen estado.

**Ejemplo: consultar el estado desde su aplicación**

```javascript theme={null}
async function checkTruthlockStatus() {
  const res = await fetch("https://status.truthlocks.com/api/health");
  const data = await res.json();

  if (data.status !== "operational") {
    console.warn(`Truthlocks is ${data.status}`);
    const issues = data.services.filter((s) => s.status !== "operational");
    issues.forEach((s) => console.warn(`  ${s.name}: ${s.status} — ${s.error}`));
  }

  return data;
}
```

**Ejemplo: verificación previa antes de la acuñación**

Verifique que los servicios de firma y atestación estén en buen estado antes de intentar una operación de acuñación. Esto evita reintentos innecesarios cuando ya sabe que los servicios requeridos están inactivos.

```javascript theme={null}
async function mintWithStatusCheck(attestation) {
  const status = await fetch("https://status.truthlocks.com/api/health");
  const health = await status.json();

  const signing = health.services.find((s) => s.id === "signing-service");
  const attestations = health.services.find(
    (s) => s.id === "attestation-service"
  );

  if (
    signing?.status !== "operational" ||
    attestations?.status !== "operational"
  ) {
    throw new Error("Required services are not operational — retry later");
  }

  return client.attestations.mint(attestation);
}
```

> [!NOTE]
>
> La API de estado tiene un límite de velocidad para evitar abusos. Para una supervisión continua,
> no sondee con una frecuencia superior a una vez cada 30 segundos.

Para ver el esquema de respuesta completo, los ID de servicio monitoreados y ejemplos adicionales, consulte la [referencia de la API de estado](https://docs.truthlocks.com/es/api-reference/health/status.md).

> [card] [Página de estado](https://status.truthlocks.com)
>
> Salud del servicio en tiempo real e historial de incidentes.

> [card] Notificaciones de webhook
>
> Los clientes empresariales pueden configurar devoluciones de llamada de webhook para cambios de estado.

> [card] [Referencia de la API de estado](https://docs.truthlocks.com/api-reference/health/status.md)
>
> Referencia completa de la API para el endpoint de estado programático.

> [card] Alertas por correo electrónico
>
> Suscríbase en la página de estado para recibir notificaciones de incidentes.

## Compromisos de nivel de servicio

Los objetivos de disponibilidad, la cobertura de soporte, los tiempos de respuesta y los créditos de servicio solo se aplican cuando se acuerdan explícitamente en el contrato aplicable. Las comprobaciones de estado públicas informan el estado del servicio observado; no establecen un porcentaje de tiempo de actividad garantizado, capacidad de recuperación de extremo a extremo o un horario de soporte con personal. Confirme la implementación actual y la evidencia de recuperación antes de confiar en un compromiso.

## Integración de monitoreo

Integre las comprobaciones de estado de Truthlocks con sus herramientas de observabilidad:

```yaml Prometheus theme={null}
# prometheus.yml
scrape_configs:
  - job_name: "truthlock-health"
    scrape_interval: 30s
    metrics_path: /metrics
    static_configs:
      - targets: ["api.truthlocks.com"]
```

```yaml Datadog theme={null}
# datadog.yaml
init_config:

instances:
  - name: truthlock_api
    url: https://api.truthlocks.com/health/ready
    timeout: 5
    content_match: '"status":"ok"'
    http_response_status_code: 200
    tags:
      - service:truthlock
      - env:production
```

```javascript Custom Dashboard Metrics theme={null}
// Export key metrics for dashboards
const metrics = {
  "truthlock.availability": isHealthy ? 1 : 0,
  "truthlock.latency_ms": responseTime,
  "truthlock.ratelimit_remaining": rateLimitRemaining,
  "truthlock.attestations_today": dailyCount,
};
```

## Resiliencia de la puerta de enlace

La puerta de enlace API incluye recuperación automática de pánico y soporte de implementación sin tiempo de inactividad:

* **Recuperación de pánico** — Si la pasarela encuentra un error interno inesperado, se recupera automáticamente y devuelve una respuesta de error estructurada en lugar de cortar su conexión. No necesita manejar las conexiones cortadas causadas por pánicos a nivel de pasarela.
* **Apagado elegante** — Durante las implementaciones, el gateway y el servicio de firma drenan las solicitudes en curso durante una ventana de 15 segundos en lugar de terminarlas inmediatamente. Si anteriormente experimentó fallos ocasionales en las solicitudes durante las ventanas de mantenimiento, estos ya no deberían ocurrir.

Estas protecciones funcionan automáticamente y no requieren cambios en su integración.

## Respuesta a incidentes

Si Truthlocks está experimentando problemas:

1. **Consultar página de estado:** [status.truthlocks.com](https://status.truthlocks.com)
2. **Habilitar disyuntor**: Falla de forma elegante en su aplicación.
3. **Operaciones de cola:** Reintentar la acuñación de atestaciones más tarde
4. **Contactar soporte:** Para escalada de SLA empresarial

### Patrón de disyuntor

```javascript theme={null}
import CircuitBreaker from "opossum";

const breaker = new CircuitBreaker(
  async (attestation) => client.attestations.mint(attestation),
  {
    timeout: 5000, // Fail if no response in 5s
    errorThresholdPercentage: 50, // Open if 50% fail
    resetTimeout: 30000, // Try again after 30s
  },
);

breaker.fallback(() => {
  // Queue for retry later
  queue.add("retry-attestation", attestation);
  return { queued: true };
});
```

## Próximos pasos

> [card] [Panel de observabilidad](https://docs.truthlocks.com/guides/observability.md)
>
> Monitoriza la salud del servicio, la latencia y el uso desde la consola.

> [card] [Referencia de errores](https://docs.truthlocks.com/ops/errors.md)
>
> Lista completa de códigos de error y manejo.

> [card] [Límites de tarifa](https://docs.truthlocks.com/ops/limits.md)
>
> Maneje la limitación de velocidad con elegancia.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.