# ClickHouse Cloud verbinden

Costfluent liest Ihre Ausgaben für ClickHouse Cloud aus der Nutzungskosten-API der Organisation, mit
einem API-Schlüssel, den Sie dafür anlegen. Eine Verbindung ist eine ClickHouse-Cloud-Organisation,
mit den Kosten jedes ihrer Data Warehouses, Services und ClickPipes.

## Wie Costfluent verbindet

Costfluent speichert Key ID und Key secret verschlüsselt und nutzt sie für zwei Abfragen: die
Organisation, zu der der Schlüssel gehört, und die täglichen Nutzungskosten dieser Organisation. Die
Organisation ist die Identität der Verbindung, Sie geben sie also nicht ein. Der Schlüssel wird nur
für diese Verbindung verwendet.

:::caution
Die Organisationsrolle **Billing** kann die Nutzung lesen und in der ClickHouse-Cloud-Konsole auch
Zahlungsmethoden verwalten. Legen Sie den Schlüssel nur für Costfluent an, damit Sie ihn widerrufen
können, ohne etwas anderes zu berühren.
:::

## Voraussetzungen

1. Die Organisationsrolle Eigentümer oder Integrationsverantwortliche Person in Costfluent.
2. Ein API-Schlüssel von ClickHouse Cloud mit der Organisationsrolle **Billing**, angelegt in der
   ClickHouse-Cloud-Konsole unter den **API Keys** der Organisation. Kopieren Sie Key ID und Key
   secret, bevor Sie diese Ansicht verlassen: ClickHouse Cloud zeigt sie nicht noch einmal an.

## Verbinden

<Stepper>

1. Öffnen Sie **Einstellungen**, dann **Integrationen**, wählen Sie **ClickHouse Cloud** und öffnen
   Sie den Tab **Verbinden**.
2. Wählen Sie **API-Schlüssel hinzufügen**, übernehmen Sie unter **Anzeigename** den vorgeschlagenen Namen oder
   geben Sie einen eigenen ein und fügen Sie die ID des Schlüssels in **Key ID** und sein Secret in
   **Key secret** ein.
3. Wählen Sie **Verbindung testen**, um jede Prüfung zu sehen, oder **Verbinden**, um zu speichern.

</Stepper>

Costfluent liest die Organisation des Schlüssels und einen Tag ihrer Nutzungskosten, bevor es etwas
speichert. Eine Verbindung, die sich speichern lässt, kann also Ihre Kosten lesen. Eine zweite
Verbindung derselben Organisation wird abgelehnt. Antwortet ClickHouse Cloud bei dieser Prüfung
nicht, wird die Verbindung trotzdem gespeichert und automatisch erneut geprüft.

## 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 ClickHouse Cloud so weit zurück Nutzung meldet. Kosten kommen pro UTC-Tag in US-Dollar an:
ClickHouse Cloud gibt die Nutzung in ClickHouse Credits an, und ein Credit ist ein US-Dollar.

:::note
ClickHouse Cloud kann die Nutzung eines Tages ändern, bis es sie sperrt, daher lesen spätere
Synchronisierungen die jüngsten Tage erneut. Ein Rabatt auf im Voraus gekaufte Credits ist nicht Teil
der Nutzungskosten-API, daher erscheinen die Kosten zu den veröffentlichten Preisen von ClickHouse
Cloud.
:::

:::caution
Wenn Sie ClickHouse Cloud über einen Cloud-Marktplatz bezahlen, stehen die Kosten auch auf der Rechnung
dieser Cloud. Wenn Sie beide verbinden, werden sie doppelt gezählt.
:::

## Berichtsdimensionen

- **Konto** ist das Data Warehouse; seine Services und ClickPipes gehören dazu.
- **Ressource** ist das Data Warehouse, der Service oder die ClickPipe, mit Namen und ID.
- **Dienst** ist `ClickHouse Cloud`, und seine **Dienstkategorie** ist `Databases`.
- **SKU** ist die Art der Ressource mit dem Kostenanteil, etwa `service/compute`,
  `datawarehouse/storage` oder `clickpipe/initialLoad`. Den Teil der Tageskosten, den ClickHouse Cloud
  nicht in Anteile aufteilt, zeigt `unitemized`, etwa `service/unitemized`, damit die Summe immer der
  von ClickHouse Cloud entspricht.
- Das Rechnungskonto ist die 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**. Über das Zahnrad daneben sehen Sie, ob die Nutzungskosten 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 ID und Secret eines
neuen API-Schlüssels derselben Organisation ein; löschen Sie danach den alten Schlüssel in der
ClickHouse-Cloud-Konsole.

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

## Fehlerbehebung

- **ClickHouse Cloud refused this key.** Die Meldung erscheint auch in der deutschen Oberfläche auf
  Englisch. Key ID oder Key secret sind falsch, oder der Schlüssel wurde gelöscht. Legen Sie einen
  neuen API-Schlüssel an und fügen Sie beide Werte ein.
- **ClickHouse Cloud refused the usage cost for this key.** Der Schlüssel darf die Nutzung nicht
  lesen. Geben Sie ihm die Organisationsrolle **Billing**.
- **This key belongs to another organization.** Erscheint beim Aktualisieren der Zugangsdaten.
  Verbinden Sie diese Organisation als neue Verbindung.
