# Datadog verbinden

Costfluent liest Ihre Datadog-Ausgaben aus der Nutzungs-API von Datadog, mit einem API-Schlüssel
und einem Anwendungsschlüssel, die Sie dafür anlegen. Eine Verbindung ist eine übergeordnete
Datadog-Organisation, mit den Kosten jeder untergeordneten Organisation darunter.

## Wie Costfluent verbindet

Costfluent speichert beide Schlüssel verschlüsselt und die Site mit ihnen; die Site, die kein
Geheimnis ist, wird auch bei der Verbindung angezeigt. Beim Verbinden fragt es Datadog,
zu welcher Organisation die Schlüssel gehören, wofür keine Berechtigung nötig ist, und liest die
Kostenschätzung des laufenden Monats, wofür die beiden Kostenberechtigungen nötig sind. Die
Organisation ist die Identität der Verbindung, daher geben Sie sie nicht ein. Danach werden die
Schlüssel nur verwendet, um die Kosten dieser Organisation zu lesen.

Die Site wird aus der Liste von Datadog gewählt, nie eingetippt, und Costfluent ruft Datadog nur
unter der API-Adresse dieser Site auf.

:::caution
Ein Anwendungsschlüssel handelt für den Benutzer oder das Dienstkonto, dem er gehört. Beschränken
Sie ihn auf `usage_read` und `billing_read` und legen Sie ihn nur für Costfluent an, am besten für
ein Dienstkonto, damit Sie ihn widerrufen können, ohne etwas anderes zu berühren.
:::

## Voraussetzungen

1. Die Organisationsrolle Eigentümer oder Integrationsverantwortliche Person in Costfluent.
2. Eine übergeordnete Datadog-Organisation mit einem Pro- oder Enterprise-Tarif: Datadog meldet
   Kosten nur der übergeordneten Organisation, und seine Nutzungs-API steht nur diesen Tarifen zur
   Verfügung. Schlüssel einer untergeordneten Organisation werden abgelehnt.
3. Ein Administrator dieser Organisation, der dort die beiden Schlüssel anlegt:
   - einen API-Schlüssel, unter "Organization Settings" → "API Keys";
   - einen Anwendungsschlüssel nur für Costfluent, am besten den eines Dienstkontos
     ("Organization Settings" → "Service Accounts"), mit den Berechtigungen `usage_read` und
     `billing_read`.
4. Die Site der Organisation: die Adresse, unter der Sie sich anmelden, ohne `app.`. Wer sich unter
   `app.datadoghq.eu` anmeldet, hat die Site `datadoghq.eu`. Die Sites sind `datadoghq.com`,
   `us3.datadoghq.com`, `us5.datadoghq.com`, `datadoghq.eu`, `ap1.datadoghq.com`,
   `ap2.datadoghq.com`, `uk1.datadoghq.com`, `ddog-gov.com` und `us2.ddog-gov.com`.

## Verbinden

<Stepper>

1. Öffnen Sie **Einstellungen**, dann **Integrationen**, wählen Sie **Datadog** und öffnen Sie den
   Tab **Verbinden**.
2. Wählen Sie **Schlüssel hinzufügen**, übernehmen Sie unter **Anzeigename** den vorgeschlagenen Namen oder
   geben Sie einen eigenen ein, fügen Sie den API-Schlüssel in
   **API-Schlüssel** und den Anwendungsschlüssel in **Anwendungsschlüssel** ein und wählen Sie die
   Site der Organisation unter **Datadog-Site**. Das Feld steht anfangs auf `datadoghq.com`.
3. Wählen Sie **Verbindung testen**, um jede Prüfung zu sehen, oder **Verbinden**, um zu speichern.

</Stepper>

Costfluent liest die Kosten des laufenden Monats, bevor es etwas speichert. Eine Verbindung, die
sich speichern lässt, kann also Ihre Kosten lesen. Eine Verbindung mit derselben Organisation wie
eine bestehende wird abgelehnt. Antwortet Datadog bei dieser Prüfung nicht auf das Lesen der Kosten,
wird die Verbindung trotzdem gespeichert und automatisch erneut geprüft.

:::note
Datadog-Kosten, die Ihre Organisation zu einem [eigenen Anbieter](/de/connect/custom-provider)
hochgeladen hat, werden doppelt gezählt, sobald die Verbindung dieselben Tage importiert, bis Sie diese
Uploads löschen ([Aktualisieren oder trennen](/de/connect/custom-provider#aktualisieren-oder-trennen)).
:::

## Daten und Aktualität

Beim Verbinden werden Kosten so weit zurück importiert, wie der rückwirkende Import Ihres Plans reicht,
höchstens sechs Monate ([Verbindungen verwalten](/de/connect/manage-connections#wie-es-sich-verhält)),
soweit Datadog so weit zurück Kosten meldet. Kosten kommen in US-Dollar an.

- **Der laufende und der vorige Monat** kommen pro UTC-Tag an, als Schätzungen von Datadog. Datadog
  nennt jeden Tag als laufende Summe des Monats bis dahin, und Costfluent erfasst den Tag als
  Differenz zum Vortag. Die Schätzungen von Datadog kommen bis zu 72 Stunden verspätet an und ändern
  sich, bis Datadog den Monat abschließt. Senkt Datadog eine laufende Summe, kann ein Tag daher
  negativ ausfallen; der Monat ergibt trotzdem den Betrag von Datadog.
- **Die endgültigen Kosten des vorigen Monats**, die Datadog bis zum 16. des Folgemonats
  veröffentlicht, werden gelesen, sobald Datadog sie für jede Organisation nennt. Die täglichen
  Schätzungen bleiben, und jede Position, deren endgültiger Betrag von ihrer Schätzung abweicht,
  erhält eine weitere Zeile am 1. des Monats mit der Differenz, sodass der Monat den endgültigen
  Betrag von Datadog ergibt. Die Zeile ist eine Nutzungsposition desselben Monats, beschrieben als
  Angleichung der Position an den endgültigen Betrag von Datadog.
- **Ältere Monate** kommen als ein Betrag je Monat an, datiert auf den 1., aus den historischen
  Kosten von Datadog.

Jede Synchronisierung liest den laufenden Monat erneut, und den vorigen Monat bis zum 20., sodass
eine geänderte Schätzung oder ein geänderter endgültiger Betrag den vorherigen ersetzt.

## Berichtsdimensionen

- **Konto** ist die Datadog-Organisation, der die Kosten berechnet wurden: die übergeordnete oder
  eine untergeordnete Organisation darunter, benannt wie in Datadog.
- **Dienst** ist das Datadog-Produkt, so wie Datadog es nennt, etwa `infra_host`. **SKU** ist
  ebenfalls das Produkt.
- Die Positionsbeschreibung ist das Produkt mit seiner Gebührenart, sodass zugesagte und
  bedarfsabhängige Gebühren eines Produkts zwei Positionen bleiben.
- **Preiskategorie** ist `Committed` für die zugesagten Gebühren von Datadog und `Standard` für alle
  übrigen.
- **Dienstkategorie** ist Management and Governance und **Dienstunterkategorie** Observability, für
  jedes Datadog-Produkt.
- Die Kosten von Datadog tragen keine Nutzungsmenge, daher gibt es keine Nutzungseinheit.
- Das Rechnungskonto ist die verbundene übergeordnete Organisation, und der Abrechnungszeitraum ist
  der Kalendermonat.

## Aktualisieren oder trennen

### Nach dem Verbinden

Der Tab **Verwalten** listet die Verbindung unter ihrem Anzeigenamen, mit ihrer
**Organisations-ID**: der öffentlichen ID der Datadog-Organisation, zu der die Schlüssel gehören.
Über das Zahnrad daneben sehen Sie, ob die Kosten noch lesbar sind, welche Workspaces die Verbindung
speist und welche Monate importiert wurden. **Prüfungen ausführen** führt die Prüfungen auf Anfrage
erneut aus.

### Zugriff rotieren oder entfernen

Wählen Sie auf der Verbindungsseite **Zugangsdaten aktualisieren** und fügen Sie einen neuen
API-Schlüssel und Anwendungsschlüssel derselben Organisation ein: **Datadog-Site** öffnet mit der Site der Verbindung.
Widerrufen Sie danach die alten Schlüssel in Datadog. Ein Schlüsselpaar einer anderen Organisation wird
abgelehnt: Verbinden Sie diese Organisation stattdessen als neue Verbindung.

Um die Verbindung aufzugeben, entfernen Sie sie in Costfluent und widerrufen Sie beide Schlüssel in
Datadog.
Das Entfernen löscht die von ihr importierten Kosten
([Verbindung entfernen](/de/connect/manage-connections#verbindung-entfernen)).

## Fehlerbehebung

- **Datadog refused these keys on datadoghq.com.** Die Meldung erscheint auch in der deutschen
  Oberfläche auf Englisch und nennt die gewählte Site. Die beiden Schlüssel gehören zu
  verschiedenen Organisationen, einer wurde widerrufen, oder die Organisation liegt auf einer
  anderen Site: Prüfen Sie die Adresse, unter der Sie sich anmelden.
- **Datadog refused the cost read for these keys (HTTP 403).** Dem Anwendungsschlüssel fehlt
  `usage_read` oder `billing_read`, oder die Schlüssel gehören zu einer untergeordneten
  Organisation. Legen Sie den Anwendungsschlüssel mit beiden Berechtigungen in der übergeordneten
  Organisation an.
