> ## Documentation Index
> Fetch the complete documentation index at: https://developers.hubspot.de/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Telemetriedaten hinzufügen (BETA)

> Erfahren Sie, wie man Telemetriedaten einrichtet.

<style>
  {`
    .table-key, .table-key div, .table-key p {
      margin: 0;
      font-size: 14px;
    }
    code {
      text-wrap:nowrap!important;
    }
    `}
</style>

Sie können für Ihre App eine Telemetriefunktion einrichten, die zur Ablage von Protokolldaten dient, um diese an einen externen Observability-Anbieter weiterzuleiten. Derzeit werden nur [Honeycomb](https://www.honeycomb.io/) und [Sentry](https://sentry.io/welcome/) als Drittanbieter unterstützt.

## Erstellen und Einrichten von Telemetriekomponentendateien

Erstellen Sie im `app/`-Verzeichnis Ihres Projekts ein `telemetry/`-Verzeichnis und fügen Sie dort eine `telemetry-hsmeta.json`-Konfigurationsdatei hinzu.

```shell theme={null}
└── src/
    └── app/
        └── telemetry/
            └── telemetry-hsmeta.json
```

Bearbeiten Sie die `telemetry-hsmeta.json`-Datei, um Ihren Anbieter, die Einstellungen auf Protokollebene usw. zu konfigurieren. Nachstehend finden Sie eine Beispieldatei sowie eine Tabelle, in der die einzelnen verfügbaren Felder aufgeführt sind.

<Warning>
  **Hinweis**: Standardmäßig werden alle Protokolltypen und -ebenen über die `logTypes`- und `logLevels`-Felder mit Ihrem Anbieter synchronisiert, was zu einem sehr hohen Datenvolumen führen kann. Deshalb wird dringend empfohlen, zunächst nur die Protokolltypen zu konfigurieren, an denen Sie interessiert sind, und die Protokollebenen so festzulegen, dass nur nach Fehlern gefiltert wird.
</Warning>

### telemetry-hsmeta.json

```json theme={null}
{
  "uid": "telemetry",
  "type": "telemetry",
  "config": {
    "providerType": "SENTRY",
    "datasetName": "my-app-telemetry",
    "logTypes": ["API_CALL", "EXTENSION_LOG", "EXTENSION_RENDER", "DATA_FETCH"],
    "logLevels": ["ERROR", "WARN", "INFO"]
  }
}
```

| Feld           | Typ          | Beschreibung                                                                                                                                                                                                                                                                                                                                                                                           |
| -------------- | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `uid`          | Zeichenfolge | Eine eindeutige ID für Ihre Telemetriekonfiguration. Dieser Wert kann auf einen beliebigen Wert festgelegt werden, wird jedoch in den Projekteinstellungen in Ihrem Account angezeigt und sollte sich daher von den `uid`-Werten anderer App-Komponenten unterscheiden.                                                                                                                                |
| `type`         | Zeichenfolge | Der Typ der Komponente, der in diesem Fall `telemetry` lauten sollte.                                                                                                                                                                                                                                                                                                                                  |
| `config`       | Objekt       | Dies ist ein Objekt, das die Konfigurationsdetails enthält; s. die Untereigenschaften in den folgenden Zeilen.                                                                                                                                                                                                                                                                                         |
| `providerType` | Zeichenfolge | Der Name Ihres Drittanbieters für Telemetriedaten. Derzeit werden nur `SENTRY` und `HONEYCOMB` unterstützt.                                                                                                                                                                                                                                                                                            |
| `datasetName`  | Zeichenfolge | Ein Label, das Ihren Protokolldaten zugeordnet wird, wenn Ihr Anbieter diese Option unterstützt.                                                                                                                                                                                                                                                                                                       |
| `logTypes`     | Array        | Eine Liste von Protokolltypen, die an Ihren externen Anbieter gesendet werden. Standardmäßig werden alle Protokolle an Ihren Anbieter weitergegeben. Die verfügbaren Protokolltypen umfassen: `["CRM_LEGACY_CARD", "CRM_EXTENSIBILITY_CARD", "WEBHOOKS", "API_CALL", "APP_SETTINGS", "SERVERLESS_EXECUTION", "PROXY_EXECUTION", "EXTENSION_RENDER", "EXTENSION_LOG", "SERVERLESS_GATEWAY_EXECUTION"]`. |
| `logLevels`    | Array        | Eine Liste von Schweregraden, nach denen Protokolle gefiltert werden sollen. Unterstützte Protokollebenen sind:  `["ERROR", "WARNING", "INFO"]`                                                                                                                                                                                                                                                        |

## Externe Authentifizierung als Geheimnis per CLI hinzufügen

Zusätzlich zum Erstellen der zuvor genannten `telemetry-hsmeta.json`-Konfigurationsdatei müssen Sie auch ein Geheimnis hinzufügen, das dem Authentifizierungsschlüssel Ihres Anbieters entspricht:

* Wenn Sie Sentry verwenden, fügen Sie den DSN (Namen der Datenquelle) als Geheimnis hinzu.
* Wenn Sie Honeycomb verwenden, fügen Sie einen API-Schlüssel als Geheimnis hinzu.

### Einen Sentry-DSN finden

Wenn Sie Sentry verwenden, führen Sie die folgenden Schritte zum DSN-Erhalt aus:

* Melden Sie sich bei Ihrem [Sentry-Konto](https://sentry.io/welcome/auth/login/) an.
* Gehen Sie zu den Einstellungen Ihres Projekts.
* Im Abschnitt *Clientschlüssel* oder im Bereich *DSN* finden Sie einen eindeutigen DSN-Eintrag für Ihr Projekt. Dieser sollte wie folgt aussehen:

```
https://sentry-key@sentry-identifier.ingest.us.sentry.io/project-id
```

### Einen Honeycomb-API-Schlüssel finden

Wenn Sie Honeycomb als externen Observability-Anbieter verwenden, wird ein API-Schlüssel zur Authentifizierung und Weiterleitung von Daten verwendet. Dieser API-Schlüssel ist mit Ihrem spezifischen Honeycomb-Account und -Projekt verknüpft.

So generieren Sie einen Honeycomb-API-Schlüssel:

* Melden Sie sich bei Ihrem [Honeycomb-Konto](https://ui.honeycomb.io/login) an.
* Gehen Sie zu den Einstellungen Ihres Projekts,
* dann zum Abschnitt *API-Schlüssel* und generieren Sie einen neuen Schlüssel.
* Kopieren Sie den generierten API-Schlüssel.

### Ein Geheimnis mithilfe des HubSpot CLI hinzufügen

Nachdem Sie entweder Ihren Sentry DSN- oder Honeycomb-API-Schlüssel erhalten haben, führen Sie den folgenden Befehl aus, um den Wert als Geheimnis hinzuzufügen. Wenn Sie zur Eingabe des Namens des Geheimnisses aufgefordert werden, <u>müssen</u> Sie `TELEMETRY_SECRET` für die korrekte Synchronisierung der Protokolldaten verwenden.

```shell theme={null}
hs app secrets add
```