Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich. # Stellen Sie eine Connect zu einer Amazon Athena Athena-Datenquelle her **Anmerkung** In Workspaces, die Version 9 oder neuer unterstützen, müssen Sie für diese Datenquelle möglicherweise das entsprechende Plugin installieren. Weitere Informationen finden Sie unter [Erweitere deinen Workspace mit Plugins](grafana-plugins.md). **Anmerkung** In diesem Handbuch wird davon ausgegangen, dass Sie mit dem Amazon Athena Athena-Service vertraut sind, bevor Sie die Athena-Datenquelle verwenden. Mit Amazon Managed Grafana können Sie Athena als Datenquelle hinzufügen, indem Sie die Datenquellenkonfigurationsoption in der AWS Grafana-Workspace-Konsole verwenden. Diese Funktion vereinfacht das Hinzufügen von Athena als Datenquelle, indem sie Ihre vorhandenen Athena-Konten erkennt und die Konfiguration der Authentifizierungsdaten verwaltet, die für den Zugriff auf Athena erforderlich sind. Sie können diese Methode verwenden, um die Authentifizierung einzurichten und Athena als Datenquelle hinzuzufügen, oder Sie können die Datenquelle und die erforderlichen Authentifizierungsdaten manuell einrichten, indem Sie dieselbe Methode verwenden, die Sie auf einem selbstverwalteten Grafana-Server verwenden würden. Es gibt Voraussetzungen, damit Athena über Amazon Managed Grafana zugänglich ist. Informationen zu den Voraussetzungen für die Verwendung der Athena-Datenquelle finden Sie unter[Voraussetzungen](Athena-prereq.md). # Voraussetzungen Um die verwalteten Richtlinien für Amazon Managed Grafana for Athena zu verwenden, führen Sie die folgenden Aufgaben aus, bevor Sie die Athena-Datenquelle konfigurieren: + Taggen Sie Ihre Athena-Arbeitsgruppen mit`GrafanaDataSource: true`. + Erstellen Sie einen S3-Bucket mit einem Namen, der mit `grafana-athena-query-results-` beginnt. Diese Richtlinie bietet Berechtigungen zum Schreiben von Abfrageergebnissen in einen S3-Bucket mit dieser Namenskonvention. Die Amazon S3 S3-Berechtigungen für den Zugriff auf die zugrunde liegende Datenquelle einer Athena-Abfrage sind in dieser verwalteten Richtlinie nicht enthalten. Sie müssen die erforderlichen Berechtigungen für die Amazon S3 S3-Buckets manuell hinzufügen case-by-case. Weitere Informationen finden Sie in diesem Handbuch unter [Beispiele für identitätsbasierte Richtlinien in Amazon Managed Grafana](https://docs.aws.amazon.com/grafana/latest/userguide/security_iam_id-based-policy-examples.html). # Verwenden Sie die AWS Datenquellenkonfiguration, um Amazon Athena als Datenquelle hinzuzufügen ## Voraussetzungen + Die [AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html) ist in Ihrer Umgebung installiert und konfiguriert. + Sie haben von Ihrem Konto aus Zugriff auf Athena. Um die AWS Datenquellenkonfiguration zu verwenden, rufen Sie zunächst die Amazon Managed Grafana-Konsole auf, um service-verwaltete IAM-Rollen zu aktivieren, die dem Workspace die IAM-Richtlinien gewähren, die zum Lesen der Athena-Ressourcen in Ihrem Konto oder in Ihren gesamten Organisationseinheiten erforderlich sind. Anschließend verwenden Sie die Amazon Managed Grafana-Workspace-Konsole, um Athena als Datenquelle hinzuzufügen. # So verwenden Sie die AWS Datenquellenkonfiguration, um Athena als Datenquelle hinzuzufügen 1. Stellen Sie sicher, dass Ihre Benutzerrolle Admin oder Editor ist. 1. Wählen Sie in der Amazon Managed Grafana-Konsole unter den Workspace aus, an [https://console.aws.amazon.com/grafana/](https://console.aws.amazon.com/grafana/home/)dem Sie arbeiten möchten. 1. Wenn Sie sich bei der Erstellung nicht dafür entschieden haben, service-verwaltete Berechtigungen für diesen Workspace zu verwenden, wechseln Sie von der Verwendung von kundenverwalteten Berechtigungen zur Verwendung von serviceverwalteten Berechtigungen, um sicherzustellen, dass die richtigen IAM-Rollen und -Richtlinien für die Verwendung der AWS Datenquellenkonfigurationsoption in der Grafana-Workspace-Konsole aktiviert sind. ****Wählen Sie dazu das Bearbeitungssymbol nach **IAM-Rolle** und wählen Sie dann Service managed, Save changes aus.**** Weitere Informationen finden Sie unter [Amazon Managed Grafana-Berechtigungen und Richtlinien für AWS Datenquellen](AMG-manage-permissions.md). 1. Wählen Sie die Registerkarte **Datenquellen**. Aktivieren Sie dann das Kontrollkästchen für **Amazon Athena** und wählen Sie **Aktionen**, **Service-Managed Policy aktivieren** aus. 1. Wählen Sie erneut die Registerkarte **Datenquellen** und wählen Sie dann **in der Zeile **Amazon Athena** die Option In Grafana konfigurieren** aus. 1. Melden Sie sich bei Bedarf mit IAM Identity Center bei der Grafana-Workspace-Konsole an. Dem Benutzer bzw. der Rolle sollte die Athena-Zugriffsrichtlinie zugewiesen sein, um Zugriff auf die Athena-Datenquelle zu erhalten. Weitere Informationen finden Sie unter [AWS verwaltete Richtlinie: AmazonGrafanaAthenaAccess](security-iam-awsmanpol.md#security-iam-awsmanpol-AmazonGrafanaAthenaAccess). 1. Wählen Sie in der linken Navigationsleiste der Grafana-Workspace-Konsole das untere AWS Symbol (es gibt zwei) und wählen Sie dann **Athena aus dem Menü** **Datenquellen**. 1. Wählen Sie die Standardregion aus, von der die Athena-Datenquelle abfragen soll, und wählen Sie dann die gewünschten Konten aus, und wählen Sie dann **Datenquelle hinzufügen** aus. 1. Folgen Sie den Schritten zur Konfiguration von **Athena Details** in [Einstellungen für **Athena Details**](#Athena-settings) ## Einstellungen für **Athena Details** **Einstellungen für **Athena Details** konfigurieren** 1. Wählen Sie im Menü **Verbindungsdetails** den Authentifizierungsanbieter aus (empfohlen: **Workspace IAM-Rolle**). 1. Wählen Sie Ihre gezielte Athena-Datenquelle aus, bei der Sie Ihr Athena-Konto haben. Wenn Sie keine Datenquelle auswählen, gibt es in der Drop-down-Liste eine Standarddatenquelle. Um ein neues Athena-Konto zu erstellen, folgen Sie den Anweisungen unter [Erste Schritte mit](https://docs.aws.amazon.com/athena/latest/ug/getting-started.html) Athena 1. Wählen Sie Ihre Ziel-Athena-Datenbank in der oben ausgewählten Datenquelle aus. 1. Wählen Sie die Arbeitsgruppe aus. Die Standardeinstellung ist „**Primär**“. 1. Wenn für Ihre Arbeitsgruppe noch kein Ausgabespeicherort konfiguriert ist, geben Sie einen S3-Bucket und einen Ordner an, der für die Abfrageergebnisse verwendet werden soll. Beispiel: `s3://grafana-athena-plugin-test-data/query-result-output/ ` 1. Wählen Sie **Speichern und testen** aus. # Manuelles Hinzufügen der Athena-Datenquelle ## Voraussetzungen + Die [AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html) ist in Ihrer Umgebung installiert und konfiguriert. + Sie haben von Ihrem Konto aus Zugriff auf **Amazon Athena**. **So fügen Sie die Athena-Datenquelle manuell hinzu:** 1. Machen Sie im Seitenmenü der Grafana-Konsole eine Pause auf dem **Konfigurationssymbol** (Zahnrad) und wählen Sie dann **Datenquellen** aus. 1. Wählen Sie **Datenquelle hinzufügen** aus. 1. Wählen Sie die **AWS Athena-Datenquelle** aus. Falls erforderlich, können Sie mit der Eingabe **Athena** in das Suchfeld beginnen, um die Suche zu erleichtern. 1. Konfigurieren Sie im Menü **Verbindungsdetails** den Authentifizierungsanbieter (empfohlen: **Workspace IAM-Rolle**) 1. Wählen Sie Ihre Ziel-Athena-Datenquelle, Datenbank und Arbeitsgruppe aus. Um ein neues Athena-Konto zu erstellen, folgen Sie den Anweisungen unter [Erste Schritte mit Athena](https://docs.aws.amazon.com/athena/latest/ug/getting-started.html). 1. Wenn für Ihre Arbeitsgruppe noch kein Ausgabespeicherort konfiguriert ist, geben Sie einen S3-Bucket und einen Ordner an, der für die Abfrageergebnisse verwendet werden soll. Beispiel, `s3://grafana-athena-plugin-test-data/query-result-output/ `. 1. Wählen Sie **Speichern und testen** aus. Das Folgende ist ein Beispiel für die Einstellungen von **Athena Details**. ![\[Beispiel für Athena Details\]](http://docs.aws.amazon.com/de_de/grafana/latest/userguide/images/athena.png) # Verwenden der Athena-Datenquelle ## IAM-Richtlinien Grafana benötigt über IAM erteilte Berechtigungen, um Athena-Metriken lesen zu können. Sie können diese Berechtigungen an IAM-Rollen anhängen und die integrierte Unterstützung von Grafana für die Übernahme von Rollen nutzen. Beachten Sie, dass Sie [die erforderliche Richtlinie für Ihre Rolle konfigurieren](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_create.html) müssen, bevor Sie die Datenquelle zu Grafana hinzufügen können. Sie benötigen eine Administrator- oder Editorrolle, um eine Datenquelle hinzuzufügen. Die integrierte Amazon Grafana Athena-Zugriffsrichtlinie ist im [AWS verwaltete Richtlinie: AmazonGrafanaAthenaAccess](security-iam-awsmanpol.md#security-iam-awsmanpol-AmazonGrafanaAthenaAccess) Abschnitt definiert. ## Athena-Daten abfragen Die Athena-Datenquelle bietet einen Standard-SQL-Abfrageeditor. Amazon Managed Grafana enthält einige Makros, die beim Schreiben komplexerer Zeitreihenabfragen helfen. Makros | Makro | Description | Beispiel | Beispiel für eine Ausgabe | | --- | --- | --- | --- | | \$1\$1\$1dateFilter(column) | \$1\$1\$1dateFiltererstellt einen bedingten Filter, der die Daten (mithilfecolumn) anhand des Datumsbereichs des Panels auswählt. | \$1\$1\$1date(my\$1date) | my\$1date BETWEEN date '2017-07-18' AND date '2017-07-18' | | \$1\$1\$1parseTime(column,format) | \$1\$1\$1parseTimewandelt ein Varchar als Zeitstempel mit dem angegebenen Format um. | \$1\$1\$1parseTime(eventtime, 'yyyy-MM-dd''T''HH:mm:ss''Z') | parse\$1datetime(time,'yyyy-MM-dd''T''HH:mm:ss''Z') | | \$1\$1\$1timeFilter(column,format) | \$1\$1\$1timeFiltererstellt eine Bedingung, die die Daten (mithilfecolumn) auf der Grundlage des Zeitbereichs des Panels filtert. Das zweite Argument wird verwendet, um die Spalte optional von einem Varchar bis zu einem Zeitstempel mit einem bestimmten Format zu analysieren. | \$1\$1\$1timeFilter(time, 'yyyy-MM-dd HH:mm:ss') | TIMESTAMP time BETWEEN TIMESTAMP '2017-07-18T11:15:52Z' AND TIMESTAMP '2017-07-18T11:15:52Z' | | \$1\$1\$1timeFrom() | \$1\$1\$1timeFromgibt die aktuelle Startzeit des Bereichs des Panels mit Anführungszeichen aus. | \$1\$1\$1timeFrom() | TIMESTAMP '2017-07-18 11:15:52' | | \$1\$1\$1timeTo() | \$1\$1\$1timeTo gibt die aktuelle Endzeit des Bereichs des Panels mit Anführungszeichen aus. | \$1\$1\$1timeTo() | TIMESTAMP '2017-07-18 11:15:52' | | \$1\$1\$1timeGroup(column, '1m', format) | \$1\$1\$1timeGroup gruppiert Zeitstempel so, dass es für jede Periode im Diagramm nur einen Punkt gibt. Das dritte Argument wird verwendet, um die Spalte optional von einem Varchar bis zu einem Zeitstempel mit einem bestimmten Format zu analysieren. | \$1\$1\$1timeGroup(time,'5m','yyyy-MM-dd''T''HH:mm:ss.SSSSSS''Z') | FROM\$1UNIXTIME(FLOOR(TO\$1UNIXTIME(parse\$1datetime(time,'yyyy-MM-dd''T''HH:mm:ss.SSSSSS''Z'))/300)\$1300) | | \$1\$1\$1table | \$1\$1\$1tablegibt die in der Tabellenauswahl ausgewählte Tabelle zurück. | \$1\$1\$1table | my\$1table | | \$1\$1\$1column | \$1\$1\$1columngibt die in der Spaltenauswahl ausgewählte Spalte zurück (es ist eine Tabelle erforderlich). | \$1\$1\$1column | col1 | **Visualisierung** Die meisten Abfragen in Athena lassen sich am besten durch eine Tabellenvisualisierung darstellen. Eine Abfrage zeigt Rückgabedaten in einer Tabelle an. Wenn sie abgefragt werden kann, kann sie als Tabelle angezeigt werden. Dieses Beispiel gibt Ergebnisse für eine Tabellenvisualisierung zurück: ``` SELECT {column_1}, {column_2} FROM {table}; ``` **Visualisierungen von Zeitreihen/Diagrammen** Für Zeitreihen- und Grafikvisualisierungen müssen Sie: + Wählen Sie eine Spalte mit einem `date` oder einem Typ aus. `datetime` Die `date` Spalte muss in aufsteigender Reihenfolge sein (mit`ORDER BY column ASC`). + wählen Sie auch eine numerische Spalte aus. **Die Abfrage wird überprüft** Amazon Managed Grafana unterstützt Makros, die Athena nicht unterstützt, was bedeutet, dass eine Abfrage möglicherweise nicht funktioniert, wenn sie direkt in Athena kopiert und eingefügt wird. Um die vollständige interpolierte Abfrage anzuzeigen, die direkt in Athena funktioniert, klicken Sie auf die Schaltfläche **Query** Inspector. **Die vollständige Abfrage wird auf der Registerkarte Abfrage angezeigt.** ## Vorlagen und Variablen Weitere Hinweise zum Hinzufügen einer Athena-Abfragevariablen finden Sie unter[Hinzufügen einer Abfragevariablen](variables-types.md#add-a-query-variable). Verwenden Sie Ihre Athena-Datenquelle als Datenquelle für die verfügbaren Abfragen. Jeder Wert, der aus einer Athena-Tabelle abgefragt wird, kann als Variable verwendet werden. Vermeiden Sie es, zu viele Werte auszuwählen, da dies zu Leistungsproblemen führen kann. Nachdem Sie eine Variable erstellt haben, können Sie sie in Ihren Athena-Abfragen verwenden, indem Sie [Syntax der Variablen](templates-and-variables.md#variable-syntax) Weitere Hinweise zu Variablen finden Sie unter[Vorlagen und Variablen](templates-and-variables.md). ## Anmerkungen [Anmerkungen](dashboard-annotations.md)ermöglichen es Ihnen, umfangreiche Ereignisinformationen über Grafiken zu legen. Sie können Anmerkungen hinzufügen, indem Sie den Bereich auswählen oder mithilfe der Ansicht **Anmerkungen im **Dashboard-Menü** Anmerkungen** Abfragen hinzufügen. Eine Beispielabfrage zum automatischen Hinzufügen von Anmerkungen: ``` SELECT time as time, environment as tags, humidity as text FROM tableName WHERE $__dateFilter(time) and humidity > 95 ``` Die folgende Tabelle enthält die Beschreibungen der Spalten, die zum Rendern von Anmerkungen verwendet werden können: | Name | Description | | --- | --- | | Time | Der Name des date/time Felds. Könnte eine Spalte mit einem systemeigenen date/time SQL-Datentyp oder Epochenwert sein. | | Timeend | Optionaler Name des date/time Endfeldes. Könnte eine Spalte mit einem systemeigenen date/time SQL-Datentyp oder Epochenwert sein. (Grafana v6.6\$1) | | Text | Feld für die Beschreibung des Ereignisses. | | Tags | Optionaler Feldname, der für Event-Tags als kommagetrennte Zeichenfolge verwendet werden soll. | ## Unterstützung für asynchrone Abfragedaten Athena-Abfragen in Amazon Managed Grafana werden asynchron verarbeitet, um Timeouts zu vermeiden. Asynchrone Abfragen verwenden separate Anfragen, um die Abfrage zu starten, dann ihren Fortschritt zu überprüfen und schließlich die Ergebnisse abzurufen. Dadurch werden Timeouts bei Abfragen vermieden, die über einen längeren Zeitraum ausgeführt werden. ## Wiederverwendung von Abfrageergebnissen Sie können die Ergebnisse früherer Abfragen wiederverwenden, um die Abfrageleistung zu verbessern. Um die Wiederverwendung von Abfragen zu aktivieren, finden Sie die Option Aktivieren im Abschnitt **Wiederverwendung von Abfrageergebnissen** des Abfrage-Editors. Dies muss für jede Abfrage erfolgen, die Sie wiederverwenden möchten. **Anmerkung** Für diese Funktion muss Ihre Athena-Instanz die Engine-Version 3 installiert haben. Weitere Informationen finden Sie unter [Ändern der Athena-Engine-Versionen](https://docs.aws.amazon.com/athena/latest/ug/engine-versions-changing.html) im *Amazon Athena Athena-Benutzerhandbuch*.