Datadog verbinden
Fügen Sie einen API-Schlüssel und einen Anwendungsschlüssel Ihrer Datadog-Organisation ein, und Costfluent importiert ihre Kosten nach Organisation und Produkt.
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.
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
- Die Organisationsrolle Eigentümer oder Integrationsverantwortliche Person in Costfluent.
- 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.
- 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_readundbilling_read.
- Die Site der Organisation: die Adresse, unter der Sie sich anmelden, ohne
app.. Wer sich unterapp.datadoghq.euanmeldet, hat die Sitedatadoghq.eu. Die Sites sinddatadoghq.com,us3.datadoghq.com,us5.datadoghq.com,datadoghq.eu,ap1.datadoghq.com,ap2.datadoghq.com,uk1.datadoghq.com,ddog-gov.comundus2.ddog-gov.com.
Verbinden
- Öffnen Sie Einstellungen, dann Integrationen, wählen Sie Datadog und öffnen Sie den Tab Verbinden.
- 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. - Wählen Sie Verbindung testen, um jede Prüfung zu sehen, oder Verbinden, um zu speichern.
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.
Datadog-Kosten, die Ihre Organisation zu einem eigenen Anbieter hochgeladen hat, werden doppelt gezählt, sobald die Verbindung dieselben Tage importiert, bis Sie diese Uploads löschen (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), 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
Committedfür die zugesagten Gebühren von Datadog undStandardfü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).
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_readoderbilling_read, oder die Schlüssel gehören zu einer untergeordneten Organisation. Legen Sie den Anwendungsschlüssel mit beiden Berechtigungen in der übergeordneten Organisation an.