# FOCUS-Export verbinden

OVHcloud und STACKIT können Ihre Kosten als FOCUS-Dateien in einen S3-kompatiblen Bucket schreiben,
der Ihnen gehört. Costfluent liest diese Dateien mit einem Zugriffsschlüssel, der den Bucket nur lesen
darf. Eine Verbindung ist ein Exportort: ein Bucket und das Präfix, unter das der Export schreibt.

## Wie Costfluent verbindet

Sie wählen den Anbieter, der die Dateien schreibt, und die Region des Buckets. Zusammen ergeben sie
den Endpunkt, von dem Costfluent liest; ein anderer Endpunkt wird nicht angenommen:

| Anbieter | Endpunkt |
|---|---|
| OVHcloud | `s3.<region>.io.cloud.ovh.net` |
| STACKIT | `object.storage.<region>.onstackit.cloud` |

Costfluent speichert Zugriffsschlüssel-ID und geheimen Zugriffsschlüssel verschlüsselt und verwendet
sie nur, um die Dateien des Exports aufzulisten und zu lesen. Die Verbindung wird an ihrem Ort
erkannt, `<endpoint>/<bucket>/<prefix>`: Eine zweite Verbindung mit demselben Ort wird abgelehnt,
und ein neuer Schlüssel für eine Verbindung muss denselben Ort erreichen.

:::caution
Costfluent kann einem Schlüssel nicht ansehen, ob er auch in den Bucket schreiben darf. Legen Sie
einen Schlüssel an, der ihn nur lesen darf, getrennt von dem Schlüssel, mit dem der Export schreibt.
:::

## Voraussetzungen

1. Die Organisationsrolle Eigentümer oder Integrationsverantwortliche Person in Costfluent.
2. Ein Bucket im Object Storage von OVHcloud oder STACKIT, in den der FOCUS-Export des Anbieters
   schreibt. Wie Sie den Export einrichten, steht unter **Export einrichten**.
3. Ein Zugriffsschlüssel, der diesen Bucket nur lesen darf, angelegt wie unter
   **Schreibgeschützten Schlüssel anlegen** beschrieben.

## Export einrichten

### OVHcloud

<Stepper>

1. Richten Sie im Control Panel von OVHcloud unter Cost Center den Export in einen Bucket ein, oder
   rufen Sie die API von OVHcloud mit `POST /v2/finops/bucketExport` auf.
2. Wählen Sie einen täglichen Export mit der Richtlinie `CREATE` oder `REPLACE`.
3. Notieren Sie das Pfadpräfix des Exports: Es ist das Präfix, das Sie in Costfluent eingeben. Hat
   der Export keines, lassen Sie das Präfix leer.

</Stepper>

### STACKIT

<Stepper>

1. Führen Sie im Portal von STACKIT den Assistenten für den FOCUS-Export aus. Er legt ein eigenes
   Servicekonto an, das die Dateien schreibt.
2. Notieren Sie den Ordner, in den der Export schreibt: Er ist das Präfix, das Sie in Costfluent
   eingeben.

</Stepper>

STACKIT schreibt die erste Datei am Tag nach der Einrichtung. Sie können schon vorher verbinden.

## Schreibgeschützten Schlüssel anlegen

### OVHcloud

Legen Sie einen Object-Storage-Benutzer an, der den Bucket des Exports nur lesen darf, und verwenden
Sie seine Zugriffsschlüssel-ID und seinen geheimen Zugriffsschlüssel.

### STACKIT

Legen Sie eine eigene Credentials Group mit einem Zugriffsschlüssel an, der den Bucket des Exports nur
lesen darf.

:::caution
Verwenden Sie für Costfluent nie die eigenen `focus-*`-Zugangsdaten des Exports. Laut STACKIT dürfen sie
nicht angetastet werden.
:::

## Verbinden

<Stepper>

1. Öffnen Sie **Einstellungen**, dann **Integrationen**, wählen Sie **FOCUS-Export** und öffnen Sie
   den Tab **Verbinden**.
2. Wählen Sie **Zugriffsschlüssel hinzufügen**, und übernehmen Sie unter
   **Anzeigename** den vorgeschlagenen Namen oder geben Sie einen eigenen ein.
3. Wählen Sie den **Anbieter** und geben Sie die **Region** des Buckets so ein, wie der Anbieter sie nennt,
   etwa `gra`, `sbg`, `de` oder `eu-west-par` bei OVHcloud oder `eu01` oder `eu02` bei STACKIT.
4. Füllen Sie **Bucket**, **Präfix** (den Ordner, in den der Export schreibt), **Zugriffsschlüssel-ID**
   und **Geheimer Zugriffsschlüssel** aus.
5. Wählen Sie **Verbindung testen**, um jede Prüfung zu sehen, oder **Verbinden**, um zu speichern.

</Stepper>

Bevor Costfluent etwas speichert, listet es das Präfix mit dem Schlüssel auf. Liegen dort schon
Exportdateien, liest es den Kopf der neuesten und lehnt eine Datei ab, die kein FOCUS ist. Ein leeres
Präfix wird akzeptiert, weil STACKIT seine erste Datei am Tag nach der Einrichtung schreibt.

## Daten und Aktualität

Costfluent importiert tägliche Kosten aus dem neuesten Export jedes Zeitraums: jedes Monats bei
OVHcloud, dessen Export bei jedem Lauf den bisherigen Monat neu schreibt, und jedes
Abrechnungszeitraums bei STACKIT. Jede Synchronisierung liest ihr Zeitfenster erneut, so dass der
laufende Monat der neuesten Datei des Anbieters folgt. Kosten kommen in der Abrechnungswährung des
Exports an.

:::note
Bis der Anbieter seine erste Datei schreibt, hat die Verbindung nichts zu importieren. Bei STACKIT
ist das der Tag nach der Einrichtung des Exports.
:::

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 der Bucket so weit zurück Exporte enthält. Schreibt der Anbieter einen neueren Export eines
abgeschlossenen Zeitraums, etwa den neu erstellten Monatsbericht von STACKIT mit seinen Gutschriften,
erfasst Costfluent diesen Zeitraum erneut, so weit zurück, wie die Historie Ihres Plans reicht,
höchstens drei Jahre.

## Berichtsdimensionen

Was jede Gruppierungsdimension eines [Kostenberichts](/de/cost-reports/explore) für einen
FOCUS-Export enthält und aus welcher FOCUS-Spalte sie stammt.

| Dimension | Bei einem FOCUS-Export | Quelle |
|---|---|---|
| **Anbietername** | Der Anbieter, den die Datei nennt, etwa OVHcloud oder STACKIT | `ServiceProviderName`, oder `ProviderName` in Dateien vor FOCUS 1.3 |
| **Unterkonto** | Das Unterkonto, das die Zeile angibt; bei einer Zeile ohne eines das Rechnungskonto | `SubAccountId`, sonst `BillingAccountId` |
| **Dienst** | Der Dienst des Anbieters | `ServiceName` |
| **Region** | Der Name der Region, den die Zeile angibt | `RegionName` |
| **Ressource** | Der Name der Ressource, den die Zeile angibt | `ResourceName` |
| **Kostenkategorie** | Die Kostenkategorie, die die Zeile angibt | `ChargeCategory` |
| **Dienstkategorie** | Die FOCUS-Kategorie, die die Zeile angibt | `ServiceCategory` |
| **SKU** | Der Zähler, den die Zeile angibt; die SKU-ID, wenn sie keinen angibt | `SkuMeter`, sonst `SkuId` |
| **Tag** | Jeder Schlüssel der Tags der Zeile, so wie er geschrieben ist | `Tags` |
| **Segment** | Ihre Zuordnungsregeln | [Segmente und Zuordnungsregeln](/de/allocation/segments) |
| **Cluster**, **Namespace** | Nie gefüllt; sie tragen Kubernetes-Kosten ([Kubernetes verbinden](/de/connect/kubernetes)) | |
| **Virtueller Tag** | Ihre Regeln für virtuelle Tags | [Virtuelle Tags](/de/allocation/virtual-tags) |

## Aktualisieren oder trennen

### Nach dem Verbinden

Der Tab **Verwalten** listet die Verbindung unter ihrem Anzeigenamen. Über das Zahnrad daneben
sehen Sie, ob der Export noch lesbar ist, 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 geben Sie denselben Anbieter,
dieselbe Region, denselben Bucket und dasselbe Präfix mit einem neuen lesenden Schlüssel ein;
löschen Sie danach den alten Schlüssel beim Anbieter. Ein Schlüssel mit einem anderen Ort wird abgelehnt.

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

## Fehlerbehebung

- **Die Verbindung lässt sich speichern, aber es kommen keine Kosten an.** Unter dem Präfix liegt
  noch kein Export. STACKIT schreibt seine erste Datei am Tag nach der Einrichtung, OVHcloud nach dem
  Zeitplan des Exports. Prüfen Sie, ob das Präfix der Ordner ist, in den der Export schreibt.
- **Der Bucket lässt sich nicht erreichen oder auflisten.** Die Region passt nicht zum Bucket, oder
  der gewählte Anbieter ist nicht der, in dessen Object Storage er liegt. Die Region ergibt den
  Endpunkt unter **Wie Costfluent verbindet**; geben Sie sie so ein, wie der Anbieter sie nennt.
- **Die neueste Datei wird abgelehnt, weil sie kein FOCUS ist.** Eine Datei im Aufbau des Exports
  unter dem Präfix hat nicht die Spalten von FOCUS: Das Präfix zeigt auf einen anderen Ordner oder
  einen anderen Export. Dateien außerhalb des Aufbaus des Exports werden übersprungen, nicht
  abgelehnt. Geben Sie das Präfix ein, unter das der Export schreibt.
- **Kosten von OVHcloud werden doppelt gezählt.** Sowohl eine Verbindung mit einem API-Schlüssel von
  [OVHcloud](/de/connect/ovhcloud) als auch ihr FOCUS-Export sind verbunden, und jede importiert
  dieselben Kosten. Verbinden Sie nur eine von beiden und entfernen Sie die andere.
