DocsDocs

Anleitungen

Anleitungen

Bestehende Learn-Guides plus kurze Hinweise für Lücken rund um Verbindungen, Ticket-On-Ramps und Coding-Runs.

Status

Bestehende Anleitungen

Die praktischen Guides bleiben unter Lernen erhalten. Diese Docs verlinken sie, damit Produktdokumentation und Schritt-für-Schritt-Anleitungen getrennt bleiben.

Verbindung prüfen

  1. Prüfe, ob OAP_CONNECTIONS_ENABLED für die Umgebung aktiv ist.
  2. Prüfe den Anbieter im Katalog und ob Tenant-Admin oder persönlicher Owner die Verbindung starten darf.
  3. Starte OAuth nur über die UI oder die dafür vorgesehenen Endpunkte.
  4. Lies bei needs_reauth, connection_revoked oder egress_blocked das Connections-Runbook.

Ticket-On-Ramp prüfen

  1. Stelle sicher, dass die Verbindung aktiv und der Anbieter für Ticket-On-Ramps geladen ist.
  2. Aktiviere die Mapping-Regel im Team.
  3. Beobachte Webhook-Gesundheit, Polling-Fallback und Circuit Breaker.
  4. Pausiere einzelne Mappings, wenn Echo-Stürme oder Schreibkonflikte auftreten.

Coding-Run sicher auswerten

Coding-Runs liefern einen validierten Work Product. Lies die Findings, Diff-Statistik, Patch-Vorschau und Push-Freigabe. Ein Push ist ein Schreibvorgang und braucht eine Approval-Bindung an den Digest.

Grundlage im Repository
  • docs/learn/de
  • docs/platform/runbooks/connections.md
  • docs/platform/runbooks/ticket-onramps.md
  • docs/platform/coding-runs.md

Guides

Guides

Existing Learn guides plus short notes for gaps around connections, ticket on-ramps and coding runs.

Status

Existing guides

The practical guides remain under Learn. These docs link to them so product documentation and step-by-step guidance stay separate.

Check a connection

  1. Check whether OAP_CONNECTIONS_ENABLED is active for the environment.
  2. Check the provider in the catalog and whether a tenant admin or personal owner may start the connection.
  3. Start OAuth only through the UI or the intended endpoints.
  4. For needs_reauth, connection_revoked or egress_blocked, read the connections runbook.

Check a ticket on-ramp

  1. Make sure the connection is active and the provider is loaded for ticket on-ramps.
  2. Activate the mapping rule in the team.
  3. Watch webhook health, polling fallback and circuit breaker state.
  4. Pause individual mappings when echo storms or write conflicts appear.

Review a coding run safely

Coding runs return a validated work product. Read findings, diff statistics, patch preview and push approval. A push is a write operation and needs an approval bound to the digest.

Repository sources
  • docs/learn/de
  • docs/platform/runbooks/connections.md
  • docs/platform/runbooks/ticket-onramps.md
  • docs/platform/coding-runs.md