Skip to content

Commit 414a54c

Browse files
feat(i18n): update translations (#2204)
Co-authored-by: icecrasher321 <[email protected]>
1 parent 3b9f0f9 commit 414a54c

File tree

11 files changed

+439
-195
lines changed

11 files changed

+439
-195
lines changed

apps/docs/content/docs/de/execution/api.mdx

Lines changed: 76 additions & 30 deletions
Original file line numberDiff line numberDiff line change
@@ -251,32 +251,78 @@ Rufen Sie Ausführungsdetails einschließlich des Workflow-Zustandsschnappschuss
251251
</Tab>
252252
</Tabs>
253253

254-
## Webhook-Abonnements
254+
## Benachrichtigungen
255255

256-
Erhalten Sie Echtzeitbenachrichtigungen, wenn Workflow-Ausführungen abgeschlossen werden. Webhooks werden über die Sim-Benutzeroberfläche im Workflow-Editor konfiguriert.
256+
Erhalten Sie Echtzeit-Benachrichtigungen, wenn Workflow-Ausführungen abgeschlossen sind, per Webhook, E-Mail oder Slack. Benachrichtigungen werden auf Workspace-Ebene von der Protokollseite aus konfiguriert.
257257

258258
### Konfiguration
259259

260-
Webhooks können für jeden Workflow über die Benutzeroberfläche des Workflow-Editors konfiguriert werden. Klicken Sie auf das Webhook-Symbol in der Kontrollleiste, um Ihre Webhook-Abonnements einzurichten.
260+
Konfigurieren Sie Benachrichtigungen von der Protokollseite aus, indem Sie auf die Menütaste klicken und "Benachrichtigungen konfigurieren" auswählen.
261261

262-
<div className="mx-auto w-full overflow-hidden rounded-lg">
263-
<Video src="configure-webhook.mp4" width={700} height={450} />
264-
</div>
262+
**Benachrichtigungskanäle:**
263+
- **Webhook**: Senden Sie HTTP POST-Anfragen an Ihren Endpunkt
264+
- **E-Mail**: Erhalten Sie E-Mail-Benachrichtigungen mit Ausführungsdetails
265+
- **Slack**: Posten Sie Nachrichten in einen Slack-Kanal
265266

266-
**Verfügbare Konfigurationsoptionen:**
267+
**Workflow-Auswahl:**
268+
- Wählen Sie bestimmte Workflows zur Überwachung aus
269+
- Oder wählen Sie "Alle Workflows", um aktuelle und zukünftige Workflows einzubeziehen
270+
271+
**Filteroptionen:**
272+
- `levelFilter`: Zu empfangende Protokollebenen (`info`, `error`)
273+
- `triggerFilter`: Zu empfangende Auslösertypen (`api`, `webhook`, `schedule`, `manual`, `chat`)
274+
275+
**Optionale Daten:**
276+
- `includeFinalOutput`: Schließt die endgültige Ausgabe des Workflows ein
277+
- `includeTraceSpans`: Schließt detaillierte Ausführungs-Trace-Spans ein
278+
- `includeRateLimits`: Schließt Informationen zum Ratenlimit ein (Sync/Async-Limits und verbleibende)
279+
- `includeUsageData`: Schließt Abrechnungszeitraum-Nutzung und -Limits ein
280+
281+
### Alarmregeln
282+
283+
Anstatt Benachrichtigungen für jede Ausführung zu erhalten, konfigurieren Sie Alarmregeln, um nur bei erkannten Problemen benachrichtigt zu werden:
284+
285+
**Aufeinanderfolgende Fehler**
286+
- Alarm nach X aufeinanderfolgenden fehlgeschlagenen Ausführungen (z.B. 3 Fehler in Folge)
287+
- Wird zurückgesetzt, wenn eine Ausführung erfolgreich ist
288+
289+
**Fehlerrate**
290+
- Alarm, wenn die Fehlerrate X% in den letzten Y Stunden überschreitet
291+
- Erfordert mindestens 5 Ausführungen im Zeitfenster
292+
- Wird erst nach Ablauf des vollständigen Zeitfensters ausgelöst
293+
294+
**Latenz-Schwellenwert**
295+
- Alarm, wenn eine Ausführung länger als X Sekunden dauert
296+
- Nützlich zum Erkennen langsamer oder hängender Workflows
297+
298+
**Latenz-Spitze**
299+
- Alarm, wenn die Ausführung X% langsamer als der Durchschnitt ist
300+
- Vergleicht mit der durchschnittlichen Dauer über das konfigurierte Zeitfenster
301+
- Erfordert mindestens 5 Ausführungen, um eine Baseline zu etablieren
302+
303+
**Kostenschwelle**
304+
- Alarmierung, wenn eine einzelne Ausführung mehr als $X kostet
305+
- Nützlich, um teure LLM-Aufrufe zu erkennen
306+
307+
**Keine Aktivität**
308+
- Alarmierung, wenn innerhalb von X Stunden keine Ausführungen stattfinden
309+
- Nützlich zur Überwachung geplanter Workflows, die regelmäßig ausgeführt werden sollten
310+
311+
**Fehlerzählung**
312+
- Alarmierung, wenn die Fehleranzahl X innerhalb eines Zeitfensters überschreitet
313+
- Erfasst die Gesamtfehler, nicht aufeinanderfolgende
314+
315+
Alle Alarmtypen beinhalten eine Abklingzeit von 1 Stunde, um Benachrichtigungsspam zu vermeiden.
316+
317+
### Webhook-Konfiguration
318+
319+
Für Webhooks stehen zusätzliche Optionen zur Verfügung:
267320
- `url`: Ihre Webhook-Endpunkt-URL
268-
- `secret`: Optionales Geheimnis für die HMAC-Signaturverifizierung
269-
- `includeFinalOutput`: Die endgültige Ausgabe des Workflows in die Nutzlast einschließen
270-
- `includeTraceSpans`: Detaillierte Ausführungs-Trace-Spans einschließen
271-
- `includeRateLimits`: Informationen zum Ratelimit des Workflow-Besitzers einschließen
272-
- `includeUsageData`: Nutzungs- und Abrechnungsdaten des Workflow-Besitzers einschließen
273-
- `levelFilter`: Array von Log-Ebenen, die empfangen werden sollen (`info`, `error`)
274-
- `triggerFilter`: Array von Auslösertypen, die empfangen werden sollen (`api`, `webhook`, `schedule`, `manual`, `chat`)
275-
- `active`: Webhook-Abonnement aktivieren/deaktivieren
321+
- `secret`: Optionales Geheimnis für HMAC-Signaturverifizierung
276322

277-
### Webhook-Nutzlast
323+
### Payload-Struktur
278324

279-
Wenn eine Workflow-Ausführung abgeschlossen ist, sendet Sim eine POST-Anfrage an Ihre Webhook-URL:
325+
Wenn eine Workflow-Ausführung abgeschlossen ist, sendet Sim die folgende Payload (über Webhook POST, E-Mail oder Slack):
280326

281327
```json
282328
{
@@ -327,17 +373,17 @@ Wenn eine Workflow-Ausführung abgeschlossen ist, sendet Sim eine POST-Anfrage a
327373

328374
### Webhook-Header
329375

330-
Jede Webhook-Anfrage enthält diese Header:
376+
Jede Webhook-Anfrage enthält diese Header (nur Webhook-Kanal):
331377

332378
- `sim-event`: Ereignistyp (immer `workflow.execution.completed`)
333379
- `sim-timestamp`: Unix-Zeitstempel in Millisekunden
334-
- `sim-delivery-id`: Eindeutige Lieferungs-ID für Idempotenz
335-
- `sim-signature`: HMAC-SHA256-Signatur zur Verifizierung (falls Secret konfiguriert)
336-
- `Idempotency-Key`: Identisch mit der Lieferungs-ID zur Erkennung von Duplikaten
380+
- `sim-delivery-id`: Eindeutige Zustell-ID für Idempotenz
381+
- `sim-signature`: HMAC-SHA256-Signatur zur Verifizierung (falls Geheimnis konfiguriert)
382+
- `Idempotency-Key`: Gleich wie Zustell-ID zur Erkennung von Duplikaten
337383

338384
### Signaturverifizierung
339385

340-
Wenn Sie ein Webhook-Secret konfigurieren, überprüfen Sie die Signatur, um sicherzustellen, dass der Webhook von Sim stammt:
386+
Wenn Sie ein Webhook-Geheimnis konfigurieren, überprüfen Sie die Signatur, um sicherzustellen, dass der Webhook von Sim stammt:
341387

342388
<Tabs items={['Node.js', 'Python']}>
343389
<Tab value="Node.js">
@@ -414,7 +460,7 @@ Fehlgeschlagene Webhook-Zustellungen werden mit exponentiellem Backoff und Jitte
414460

415461
- Maximale Versuche: 5
416462
- Wiederholungsverzögerungen: 5 Sekunden, 15 Sekunden, 1 Minute, 3 Minuten, 10 Minuten
417-
- Jitter: Bis zu 10% zusätzliche Verzögerung, um Überlastungen zu vermeiden
463+
- Jitter: Bis zu 10% zusätzliche Verzögerung, um Überlastung zu vermeiden
418464
- Nur HTTP 5xx und 429 Antworten lösen Wiederholungen aus
419465
- Zustellungen haben ein Timeout nach 30 Sekunden
420466

@@ -424,15 +470,15 @@ Fehlgeschlagene Webhook-Zustellungen werden mit exponentiellem Backoff und Jitte
424470

425471
## Best Practices
426472

427-
1. **Polling-Strategie**: Verwenden Sie beim Abfragen von Logs die cursorbasierte Paginierung mit `order=asc` und `startDate`, um neue Logs effizient abzurufen.
473+
1. **Polling-Strategie**: Verwende bei der Abfrage von Logs eine cursor-basierte Paginierung mit `order=asc` und `startDate`, um neue Logs effizient abzurufen.
428474

429-
2. **Webhook-Sicherheit**: Konfigurieren Sie immer ein Webhook-Secret und überprüfen Sie Signaturen, um sicherzustellen, dass Anfragen von Sim stammen.
475+
2. **Webhook-Sicherheit**: Konfiguriere immer ein Webhook-Secret und überprüfe Signaturen, um sicherzustellen, dass Anfragen von Sim stammen.
430476

431-
3. **Idempotenz**: Verwenden Sie den `Idempotency-Key`Header, um doppelte Webhook-Zustellungen zu erkennen und zu behandeln.
477+
3. **Idempotenz**: Verwende den `Idempotency-Key`Header, um doppelte Webhook-Zustellungen zu erkennen und zu behandeln.
432478

433-
4. **Datenschutz**: Standardmäßig werden `finalOutput` und `traceSpans` von den Antworten ausgeschlossen. Aktivieren Sie diese nur, wenn Sie die Daten benötigen und die Datenschutzauswirkungen verstehen.
479+
4. **Datenschutz**: Standardmäßig werden `finalOutput` und `traceSpans` aus den Antworten ausgeschlossen. Aktiviere diese nur, wenn du die Daten benötigst und die Datenschutzauswirkungen verstehst.
434480

435-
5. **Rate-Limiting**: Implementieren Sie exponentielles Backoff, wenn Sie 429-Antworten erhalten. Überprüfen Sie den `Retry-After`Header für die empfohlene Wartezeit.
481+
5. **Rate-Limiting**: Implementiere exponentielles Backoff, wenn du 429-Antworten erhältst. Überprüfe den `Retry-After`Header für die empfohlene Wartezeit.
436482

437483
## Rate-Limiting
438484

@@ -443,7 +489,7 @@ Die API implementiert Rate-Limiting, um eine faire Nutzung zu gewährleisten:
443489
- **Team-Plan**: 60 Anfragen pro Minute
444490
- **Enterprise-Plan**: Individuelle Limits
445491

446-
Informationen zum Rate-Limit sind in den Antwort-Headern enthalten:
492+
Rate-Limit-Informationen sind in den Antwort-Headern enthalten:
447493
- `X-RateLimit-Limit`: Maximale Anfragen pro Zeitfenster
448494
- `X-RateLimit-Remaining`: Verbleibende Anfragen im aktuellen Zeitfenster
449495
- `X-RateLimit-Reset`: ISO-Zeitstempel, wann das Zeitfenster zurückgesetzt wird
@@ -495,7 +541,7 @@ async function pollLogs() {
495541
setInterval(pollLogs, 30000);
496542
```
497543

498-
## Beispiel: Verarbeitung von Webhooks
544+
## Beispiel: Verarbeiten von Webhooks
499545

500546
```javascript
501547
import express from 'express';

apps/docs/content/docs/de/execution/logging.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -147,4 +147,4 @@ Der Snapshot bietet:
147147

148148
- Erfahren Sie mehr über die [Kostenberechnung](/execution/costs), um die Preisgestaltung von Workflows zu verstehen
149149
- Erkunden Sie die [externe API](/execution/api) für programmatischen Zugriff auf Protokolle
150-
- Richten Sie [Webhook-Benachrichtigungen](/execution/api#webhook-subscriptions) für Echtzeit-Warnungen ein
150+
- Richten Sie [Benachrichtigungen](/execution/api#notifications) für Echtzeit-Warnungen per Webhook, E-Mail oder Slack ein

apps/docs/content/docs/es/execution/api.mdx

Lines changed: 74 additions & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -251,32 +251,78 @@ Recupera detalles de ejecución incluyendo la instantánea del estado del flujo
251251
</Tab>
252252
</Tabs>
253253

254-
## Suscripciones a webhooks
254+
## Notificaciones
255255

256-
Recibe notificaciones en tiempo real cuando se completan las ejecuciones de flujos de trabajo. Los webhooks se configuran a través de la interfaz de usuario de Sim en el editor de flujos de trabajo.
256+
Recibe notificaciones en tiempo real cuando se completan las ejecuciones de flujos de trabajo a través de webhook, correo electrónico o Slack. Las notificaciones se configuran a nivel de espacio de trabajo desde la página de Registros.
257257

258258
### Configuración
259259

260-
Los webhooks pueden configurarse para cada flujo de trabajo a través de la interfaz de usuario del editor de flujos de trabajo. Haz clic en el icono de webhook en la barra de control para configurar tus suscripciones a webhooks.
260+
Configura las notificaciones desde la página de Registros haciendo clic en el botón de menú y seleccionando "Configurar notificaciones".
261261

262-
<div className="mx-auto w-full overflow-hidden rounded-lg">
263-
<Video src="configure-webhook.mp4" width={700} height={450} />
264-
</div>
262+
**Canales de notificación:**
263+
- **Webhook**: Envía solicitudes HTTP POST a tu punto de conexión
264+
- **Correo electrónico**: Recibe notificaciones por correo con detalles de la ejecución
265+
- **Slack**: Publica mensajes en un canal de Slack
265266

266-
**Opciones de configuración disponibles:**
267-
- `url`: URL del punto final de tu webhook
267+
**Selección de flujos de trabajo:**
268+
- Selecciona flujos de trabajo específicos para monitorear
269+
- O elige "Todos los flujos de trabajo" para incluir los flujos actuales y futuros
270+
271+
**Opciones de filtrado:**
272+
- `levelFilter`: Niveles de registro a recibir (`info`, `error`)
273+
- `triggerFilter`: Tipos de disparadores a recibir (`api`, `webhook`, `schedule`, `manual`, `chat`)
274+
275+
**Datos opcionales:**
276+
- `includeFinalOutput`: Incluir la salida final del flujo de trabajo
277+
- `includeTraceSpans`: Incluir trazas detalladas de la ejecución
278+
- `includeRateLimits`: Incluir información de límites de tasa (límites sincrónicos/asincrónicos y restantes)
279+
- `includeUsageData`: Incluir uso y límites del período de facturación
280+
281+
### Reglas de alerta
282+
283+
En lugar de recibir notificaciones por cada ejecución, configura reglas de alerta para ser notificado solo cuando se detecten problemas:
284+
285+
**Fallos consecutivos**
286+
- Alerta después de X ejecuciones fallidas consecutivas (por ejemplo, 3 fallos seguidos)
287+
- Se reinicia cuando una ejecución tiene éxito
288+
289+
**Tasa de fallos**
290+
- Alerta cuando la tasa de fallos supera el X% durante las últimas Y horas
291+
- Requiere un mínimo de 5 ejecuciones en la ventana de tiempo
292+
- Solo se activa después de que haya transcurrido la ventana de tiempo completa
293+
294+
**Umbral de latencia**
295+
- Alerta cuando cualquier ejecución tarda más de X segundos
296+
- Útil para detectar flujos de trabajo lentos o bloqueados
297+
298+
**Pico de latencia**
299+
- Alerta cuando la ejecución es X% más lenta que el promedio
300+
- Compara con la duración promedio durante la ventana de tiempo configurada
301+
- Requiere un mínimo de 5 ejecuciones para establecer una línea base
302+
303+
**Umbral de costo**
304+
- Alerta cuando una sola ejecución cuesta más de $X
305+
- Útil para detectar llamadas costosas a LLM
306+
307+
**Sin actividad**
308+
- Alerta cuando no ocurren ejecuciones dentro de X horas
309+
- Útil para monitorear flujos de trabajo programados que deberían ejecutarse regularmente
310+
311+
**Recuento de errores**
312+
- Alerta cuando el recuento de errores excede X dentro de una ventana de tiempo
313+
- Rastrea errores totales, no consecutivos
314+
315+
Todos los tipos de alertas incluyen un período de enfriamiento de 1 hora para evitar el spam de notificaciones.
316+
317+
### Configuración de webhook
318+
319+
Para webhooks, hay opciones adicionales disponibles:
320+
- `url`: La URL de tu endpoint webhook
268321
- `secret`: Secreto opcional para verificación de firma HMAC
269-
- `includeFinalOutput`: Incluir la salida final del flujo de trabajo en la carga útil
270-
- `includeTraceSpans`: Incluir intervalos de seguimiento de ejecución detallados
271-
- `includeRateLimits`: Incluir información del límite de tasa del propietario del flujo de trabajo
272-
- `includeUsageData`: Incluir datos de uso y facturación del propietario del flujo de trabajo
273-
- `levelFilter`: Array de niveles de registro a recibir (`info`, `error`)
274-
- `triggerFilter`: Array de tipos de disparadores a recibir (`api`, `webhook`, `schedule`, `manual`, `chat`)
275-
- `active`: Habilitar/deshabilitar la suscripción al webhook
276322

277-
### Carga útil del webhook
323+
### Estructura de carga útil
278324

279-
Cuando se completa la ejecución de un flujo de trabajo, Sim envía una solicitud POST a tu URL de webhook:
325+
Cuando se completa la ejecución de un flujo de trabajo, Sim envía la siguiente carga útil (vía webhook POST, correo electrónico o Slack):
280326

281327
```json
282328
{
@@ -325,9 +371,9 @@ Cuando se completa la ejecución de un flujo de trabajo, Sim envía una solicitu
325371
}
326372
```
327373

328-
### Cabeceras de webhook
374+
### Encabezados de webhook
329375

330-
Cada solicitud de webhook incluye estas cabeceras:
376+
Cada solicitud de webhook incluye estos encabezados (solo canal webhook):
331377

332378
- `sim-event`: Tipo de evento (siempre `workflow.execution.completed`)
333379
- `sim-timestamp`: Marca de tiempo Unix en milisegundos
@@ -416,39 +462,39 @@ Las entregas de webhook fallidas se reintentan con retroceso exponencial y fluct
416462
- Retrasos de reintento: 5 segundos, 15 segundos, 1 minuto, 3 minutos, 10 minutos
417463
- Fluctuación: Hasta un 10% de retraso adicional para prevenir el efecto de manada
418464
- Solo las respuestas HTTP 5xx y 429 activan reintentos
419-
- Las entregas agotan el tiempo de espera después de 30 segundos
465+
- Las entregas agotan el tiempo después de 30 segundos
420466

421467
<Callout type="info">
422-
Las entregas de webhook se procesan de forma asíncrona y no afectan al rendimiento de ejecución del flujo de trabajo.
468+
Las entregas de webhook se procesan de forma asíncrona y no afectan el rendimiento de ejecución del flujo de trabajo.
423469
</Callout>
424470

425471
## Mejores prácticas
426472

427-
1. **Estrategia de sondeo**: Al sondear registros, utiliza paginación basada en cursor con `order=asc` y `startDate` para obtener nuevos registros de manera eficiente.
473+
1. **Estrategia de sondeo**: Cuando consultes registros, utiliza paginación basada en cursores con `order=asc` y `startDate` para obtener nuevos registros de manera eficiente.
428474

429475
2. **Seguridad de webhook**: Siempre configura un secreto de webhook y verifica las firmas para asegurar que las solicitudes provienen de Sim.
430476

431477
3. **Idempotencia**: Utiliza la cabecera `Idempotency-Key` para detectar y manejar entregas duplicadas de webhook.
432478

433479
4. **Privacidad**: Por defecto, `finalOutput` y `traceSpans` están excluidos de las respuestas. Habilítalos solo si necesitas los datos y comprendes las implicaciones de privacidad.
434480

435-
5. **Limitación de tasa**: Implementa retroceso exponencial cuando recibas respuestas 429. Consulta la cabecera `Retry-After` para conocer el tiempo de espera recomendado.
481+
5. **Limitación de tasa**: Implementa retroceso exponencial cuando recibas respuestas 429. Verifica la cabecera `Retry-After` para conocer el tiempo de espera recomendado.
436482

437483
## Limitación de tasa
438484

439-
La API implementa limitación de tasa para garantizar un uso justo:
485+
La API implementa limitación de tasa para asegurar un uso justo:
440486

441487
- **Plan gratuito**: 10 solicitudes por minuto
442488
- **Plan Pro**: 30 solicitudes por minuto
443489
- **Plan Team**: 60 solicitudes por minuto
444490
- **Plan Enterprise**: Límites personalizados
445491

446-
La información del límite de tasa se incluye en los encabezados de respuesta:
447-
- `X-RateLimit-Limit`: Máximo de solicitudes por ventana
492+
La información de límite de tasa se incluye en las cabeceras de respuesta:
493+
- `X-RateLimit-Limit`: Solicitudes máximas por ventana
448494
- `X-RateLimit-Remaining`: Solicitudes restantes en la ventana actual
449-
- `X-RateLimit-Reset`: Marca de tiempo ISO cuando se reinicia la ventana
495+
- `X-RateLimit-Reset`: Marca de tiempo ISO cuando la ventana se reinicia
450496

451-
## Ejemplo: Sondeo para nuevos registros
497+
## Ejemplo: Sondeo de nuevos registros
452498

453499
```javascript
454500
let cursor = null;

apps/docs/content/docs/es/execution/logging.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -147,4 +147,4 @@ La instantánea proporciona:
147147

148148
- Aprende sobre [Cálculo de costos](/execution/costs) para entender los precios de los flujos de trabajo
149149
- Explora la [API externa](/execution/api) para acceso programático a los registros
150-
- Configura [notificaciones por Webhook](/execution/api#webhook-subscriptions) para alertas en tiempo real
150+
- Configura [Notificaciones](/execution/api#notifications) para alertas en tiempo real vía webhook, correo electrónico o Slack

0 commit comments

Comments
 (0)