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. # WorkSpaces Berichte zur Nutzung von Anwendungen Sie können Nutzungsberichte von Amazon WorkSpaces Applications abonnieren, um detaillierte Berichte darüber zu erhalten, wie Ihre Benutzer den Service nutzen. Zwei CSV-Dateien werden täglich in einen Amazon Simple Storage Service (Amazon S3) -Bucket in Ihrem Konto exportiert. **Anmerkung** Um Berichte zur WorkSpaces Anwendungsnutzung zu aktivieren, müssen Sie ein Image verwenden, das eine Version des WorkSpaces Applications Agent verwendet, die am oder nach dem 7. Mai 2019 veröffentlicht wurde. **Topics** + [Nutzungsberichte WorkSpaces für Anwendungen aktivieren](enable-usage-reports.md) + [WorkSpaces Felder für Anwendungsnutzungsberichte](usage-reports-fields.md) + [Erstellen Sie benutzerdefinierte Berichte und analysieren Sie die Nutzungsdaten von WorkSpaces Anwendungen](configure-custom-reports-analyze-usage-data.md) # Nutzungsberichte WorkSpaces für Anwendungen aktivieren Um Nutzungsberichte zu erhalten, abonnieren Sie diese, indem Sie die WorkSpaces Anwendungskonsole, die AWS Command Line Interface (AWS CLI) oder die `CreateUsageReportSubscription` API-Operation verwenden. Sie müssen Nutzungsberichte für jede AWS Region, für die Sie Nutzungsdaten erhalten möchten, separat aktivieren. **Anmerkung** Sie können Ihr Abonnement von Nutzungsberichten jederzeit beginnen oder beenden. Es fallen keine Gebühren für das Abonnement von Nutzungsberichten an. Es können jedoch-Amazon-S3-Standardgebühren für Berichte anfallen, die in Ihrem S3-Bucket gespeichert werden. Weitere Informationen finden Sie unter [Amazon S3 – Preise](https://aws.amazon.com/s3/pricing/). Gehen Sie wie folgt vor, um Nutzungsberichte für WorkSpaces WorkSpaces Anwendungen mithilfe der Anwendungskonsole zu abonnieren. 1. Öffnen Sie die WorkSpaces Anwendungskonsole zu [https://console.aws.amazon.com/appstream2/Hause](https://console.aws.amazon.com/appstream2/home). 1. Wählen Sie die AWS Region aus, für die Sie Nutzungsberichte aktivieren möchten. 1. Klicken Sie im Navigationsbereich auf **Nutzungsberichte**. 1. Wählen Sie **Enabled** und anschließend **Apply** aus. Wenn Sie On-Instance-Sitzungsskripts und Amazon S3 S3-Protokollierung für Ihre Sitzungsskriptkonfiguration aktiviert haben, hat WorkSpaces Applications einen S3-Bucket zum Speichern der Skriptausgabe erstellt. Dieser Bucket ist für Ihr Konto und Ihre Region eindeutig. Wenn Sie in diesem Fall die Nutzungsberichterstattung aktivieren, verwendet WorkSpaces Applications denselben Bucket zum Speichern Ihrer Nutzungsberichte. Wenn Sie Sitzungsskripts auf der Instanz noch nicht aktiviert haben, erstellt WorkSpaces Applications bei der Aktivierung von Nutzungsberichten einen neuen S3-Bucket am folgenden Speicherort: ``` appstream-logs-region-code-account-id-without-hyphens-random-identifier ``` ***region-code*** Der AWS Regionalcode für die Region, in der die Nutzungsberichterstattung aktiviert ist. ***account-id-without-hyphens*** Ihre Konto-ID für Amazon Web Services. Die zufällige ID stellt sicher, dass keine Konflikte mit anderen Buckets in dieser Region auftreten. Der erste Teil des Bucket-Namens, `appstream-logs`, ändert sich konto- oder regionsübergreifend nicht. Wenn Sie beispielsweise die Nutzungsberichterstattung in der Region USA West (Oregon) (us-west-2) unter der Kontonummer 123456789012 aktivieren, erstellt WorkSpaces Applications innerhalb Ihres Kontos in dieser Region einen Amazon S3 S3-Bucket, der dem Namen im folgenden Beispiel ähnelt: ``` appstream-logs-us-west-2-1234567890123-abcdefg ``` Nur ein Administrator mit ausreichenden Berechtigungen kann diesen Bucket löschen. **Topics** + [WorkSpaces Anwendungen, Sitzungen, Berichte](usage-report-types-sessions-reports.md) + [WorkSpaces Anwendungen, Anwendungen, Berichte](usage-report-types-applications-reports.md) # WorkSpaces Anwendungen, Sitzungen, Berichte Für jeden Tag, an dem Benutzer mindestens eine Streaming-Sitzung in Ihrem Amazon Web Services Services-Konto starten, exportiert WorkSpaces Applications einen Sitzungsbericht in Ihren Amazon S3 S3-Bucket. Der Bericht mit dem Namen **daily-session-report- [YYYY] - [MM] - [DD] .csv** wird in einer verschachtelten Ordnerstruktur in Ihrem Amazon S3 S3-Konto gespeichert, wobei der folgende Ordnerpfad verwendet wird: [Bucket\$1Name]/= [DD]/sessions/schedule=DAILY/year=[YYYY]/month=[MM]/day Diese Verschachtelungsstruktur erleichtert die Partitionierung, wenn Sie Ihre Berichte mithilfe von Amazon Athena abfragen möchten. Athena ist ein interaktiver Serverless-Abfrageservice, mit dem Sie in Ihren S3-Buckets gespeicherte Daten mit SQL-Standardabfragen analysieren können. Weitere Informationen finden Sie unter [Erstellen Sie benutzerdefinierte Berichte und analysieren Sie die Nutzungsdaten von WorkSpaces Anwendungen](configure-custom-reports-analyze-usage-data.md). Jede Benutzersitzung wird in einem einzelnen Datensatz in einem Sitzungsbericht beschrieben. Sitzungsberichte werden täglich innerhalb von 24 Stunden nach Ende des entsprechenden Tages nach UTC-Zeit generiert. Wenn eine Sitzung mehrere Tage umfasst, wird der Datensatz zur Sitzung im Sitzungsbericht zu dem Tag angezeigt, in dem die Sitzung endet. Weitere Informationen zu den in Sitzungsberichten enthaltenen Daten finden Sie unter [Felder in Sitzungsberichten](usage-reports-fields-sessions-reports.md). # WorkSpaces Anwendungen, Anwendungen, Berichte Für jeden Tag, an dem Benutzer während ihrer Streaming-Sitzungen mindestens eine Anwendung starten, exportiert WorkSpaces Applications einen Anwendungsbericht in Ihren Amazon S3 S3-Bucket. Der Bericht mit dem Namen **daily-app-report- [YYYY] - [MM] - [DD] .csv** wird in einer verschachtelten Ordnerstruktur in Ihrem Amazon S3 S3-Konto gespeichert, wobei der folgende Ordnerpfad verwendet wird: [Bucket\$1Name]/= [DD]/applications/schedule=DAILY/year=[YYYY]/month=[MM]/day Diese Verschachtelungsstruktur erleichtert die Partitionierung, wenn Sie Ihre Berichte mithilfe von Amazon Athena abfragen möchten. Athena ist ein interaktiver Serverless-Abfrageservice, mit dem Sie in Ihren S3-Buckets gespeicherte Daten mit SQL-Standardabfragen analysieren können. Weitere Informationen finden Sie unter [Erstellen Sie benutzerdefinierte Berichte und analysieren Sie die Nutzungsdaten von WorkSpaces Anwendungen](configure-custom-reports-analyze-usage-data.md). Jeder Anwendungsstart wird in einem einzelnen Datensatz in einem Anwendungsbericht beschrieben. Beispiel: Wenn ein Benutzer während einer Sitzung fünf separate Anwendungen startet, werden fünf separate Datensätze in den entsprechenden Anwendungsberichten angezeigt. Eine Anwendung wird in den folgenden Fällen als gestartet erfasst: + Die Anwendung wird direkt bei Sitzungsbeginn gestartet, da die Anwendungs-ID entweder in der Streaming-URL oder im Relais-Status eingebettet ist. + Ein Benutzer wählt die Anwendung aus dem Anwendungskatalog aus, wenn er eine neue Streaming-Sitzung startet. + Ein Benutzer wählt die Anwendung während einer Streaming-Sitzung aus der Anwendungskatalogliste aus. Anwendungen, die auf andere Weise gestartet wurden, sind im Anwendungsbericht nicht enthalten. Wenn Sie Benutzern beispielsweise Zugriff auf Windows Explorer oder das **Windows-Desktop-Startmenü** gewähren und Benutzer diese Tools verwenden, um Anwendungen direkt zu starten, oder wenn ein anderes Programm oder Skript eine Anwendung startet, sind diese Anwendungsstarts nicht im Anwendungsbericht enthalten. PowerShell Anwendungsberichte werden täglich innerhalb von 24 Stunden nach Ende des entsprechenden Tages nach UTC-Zeit generiert. Wenn eine Sitzung mehrere Tage umfasst, werden die Datensätze zu den während dieser Sitzung gestarteten Anwendungen im Anwendungsbericht zu dem Tag angezeigt, in dem die Sitzung endet. Weitere Informationen zu den in Anwendungsberichten enthaltenen Daten finden Sie unter [Felder in Anwendungsberichten](usage-reports-fields-applications-reports.md). # WorkSpaces Felder für Anwendungsnutzungsberichte Dieses Thema enthält Informationen zu den Feldern, die in Berichten zur WorkSpaces Anwendungsnutzung enthalten sind. **Topics** + [Felder in Sitzungsberichten](usage-reports-fields-sessions-reports.md) + [Felder in Anwendungsberichten](usage-reports-fields-applications-reports.md) # Felder in Sitzungsberichten In der folgenden Tabelle werden die Felder beschrieben, die in Berichten über WorkSpaces Anwendungssitzungen enthalten sind. | Feldname | Description | | --- | --- | | user\$1session\$1id | Der eindeutige Bezeichner (ID) für die Sitzung | | aws\$1account\$1id | Die Konto-ID von Amazon Web Services. | | region | Die AWS Region. | | session\$1start\$1time | Datum und Uhrzeit des Sitzungsbeginns Muss im ISO 8601-Format und in UTC-Zeit angegeben werden. | | session\$1end\$1time | Datum und Uhrzeit des Sitzungsendes Muss im ISO 8601-Format und in UTC-Zeit angegeben werden. | | session\$1duration\$1in\$1seconds | Die Dauer der Sitzung in Sekunden | | user\$1id | Die eindeutige ID für den Benutzer innerhalb des Authentifizierungstyps | | user\$1arn | Der Amazon-Ressourcenname (ARN) für den Benutzer | | authentication\$1type | Die für die Authentifizierung des Benutzers verwendete Methode Mögliche Werte: `CUSTOM` \$1 `SAML` \$1 `USERPOOL` | | authentication\$1type\$1user\$1id | Die Verkettung von Benutzer-ID und Authentifizierungstyp, die den Benutzer für die Veranschlagung von Benutzergebühren eindeutig identifizieren. Weitere Informationen finden Sie unter [Preise für WorkSpaces Anwendungen](https://aws.amazon.com/appstream2/pricing/). | | fleet\$1name | Der Name der mit der Sitzung verknüpften Flotte | | stack\$1name | Der Name des mit der Sitzung verknüpften Stacks | | instance\$1type | Der Instanztyp der WorkSpaces Anwendungen, der für die Sitzung verwendet wird. Eine Liste der Instance-Typen finden Sie unter [Preise WorkSpaces für Anwendungen](https://aws.amazon.com/appstream2/pricing/). | | eni\$1private\$1ip\$1address | Die IP-Adresse der elastic network interface, die von der WorkSpaces Applications Instance für die Netzwerkkommunikation verwendet wird. | | connected\$1at\$1least\$1once | Gibt an, ob der Benutzer mindestens einmal eine Verbindung zur Sitzung hergestellt hat. Mögliche Werte: `true` \$1 `false` | | client\$1ip\$1addresses | Die mit dem/den für die Sitzung verwendeten Benutzer-Gerät(en) verknüpften IP-Adressen. Wenn der Benutzer mehr als einmal eine Verbindung mit der Sitzung hergestellt und wieder getrennt hat, werden die letzten 10 einzelnen IP-Adressen gespeichert. Dabei werden sie durch Semikolons voneinander getrennt. | | google\$1drive\$1enabled | Gibt an, ob Google Drive als persistenter Speicher für die Sitzung aktiviert war. Weitere Informationen finden Sie unter [Aktivieren und verwalten Sie Google Drive für die Nutzer Ihrer Anwendungen WorkSpaces](google-drive.md). Mögliche Werte: `true` \$1 `false` | | one\$1drive\$1enabled | Gibt an, ob als persistente Speicheroption für die Sitzung aktiviert OneDrive wurde. Weitere Informationen finden Sie unter [Aktivieren und verwalten Sie Google Drive für die Nutzer Ihrer Anwendungen WorkSpaces](google-drive.md). Mögliche Werte: `true` \$1 `false` | | home\$1folders\$1storage\$1location | Der für in Basisordnern gespeicherte Dateien verwendete Amazon-S3-Bucket | | user\$1settings\$1clipboard\$1copy\$1from\$1local\$1device | Gibt an, ob der Benutzer während der Sitzung Daten mithilfe der Zwischenablage aus dem lokalen Gerät in die Streaming-Sitzung kopieren konnte. Mögliche Werte: `ENABLED` \$1 `DISABLED` | | user\$1settings\$1clipboard\$1copy\$1to\$1local\$1device | Gibt an, ob der Benutzer während der Sitzung Daten mithilfe der Zwischenablage aus der Streaming-Sitzung auf das lokale Gerät kopieren konnte. Mögliche Werte: `ENABLED` \$1 `DISABLED` | | user\$1settings\$1file\$1upload | Gibt an, ob der Benutzer während der Sitzung Dateien aus dem lokalen Gerät in die Streaming-Sitzung hochladen konnte. Mögliche Werte: `ENABLED` \$1 `DISABLED` | | user\$1settings\$1file\$1download | Gibt an, ob der Benutzer während der Sitzung Dateien aus der Streaming-Sitzung auf das lokale Gerät hochladen konnte. Mögliche Werte: `ENABLED` \$1 `DISABLED` | | user\$1settings\$1printing\$1to\$1local\$1device | Gibt an, ob der Benutzer während der Sitzung Dateien aus der Streaming-Sitzung auf das lokale Gerät drucken konnte. Mögliche Werte: `ENABLED` \$1 `DISABLED` | | application\$1settings\$1enabled | Gibt an, ob Persistenz von Anwendungseinstellungen für die Sitzung aktiviert war. Mögliche Werte: `true` \$1 `false` | | domain\$1joined | Gibt an, ob die WorkSpaces Anwendungsstreaming-Instanz beim Sitzungsstart einer Active Directory-Domäne hinzugefügt wurde. Weitere Informationen finden Sie unter [Active Directory mit WorkSpaces Anwendungen verwenden](active-directory.md). Mögliche Werte: `Y` \$1 `N` | | max\$1session\$1duration | Die maximal zulässige Dauer der Sitzung in Sekunden | | session\$1type | Der Sitzungstyp Mögliche Werte: `ALWAYS_ON` \$1 `ON_DEMAND` | | stream\$1view | Die Stream-Ansicht Mögliche Werte: `APPLICATION` \$1 `DESKTOP` | | streaming\$1experience\$1settings\$1protocol | Das Protokoll, mit dem das Streaming der Sitzung beendet wurde Mögliche Werte: `UDP` \$1 `TCP` | | instance\$1id | Die der Benutzersitzung zugeordnete Instance-ID. | | is\$1multisession | Gibt an, ob die Sitzung zu einer Flotte mit mehreren Sitzungen gehört. Mögliche Werte: `true` \$1 `false` | # Felder in Anwendungsberichten In der folgenden Tabelle werden die Felder beschrieben, die in Berichten über WorkSpaces Anwendungen enthalten sind. | Feldname | Description | | --- | --- | | user\$1session\$1id | Der eindeutige Bezeichner (ID) für die Sitzung | | application\$1name | Der Name der Anwendung wie im Image Assistant angegeben Dieser Wert wird bereitgestellt, wenn ein Benutzer eine Anwendung über die WorkSpaces Anwendungsschnittstelle startet. | | schedule | Die Häufigkeit der Berichtsgenerierung Möglicher Wert: DAILY | | Jahr | Das Jahr des Berichts | | Monat | Der Monat des Berichts | | Tag | Der Tag des Berichts | # Erstellen Sie benutzerdefinierte Berichte und analysieren Sie die Nutzungsdaten von WorkSpaces Anwendungen Amazon Athena ist ein interaktiver Serverless-Abfrageservice, mit dem Sie in Ihren S3-Buckets gespeicherte Daten mit SQL-Standardabfragen analysieren können. Sie können Athena verwenden, um Ihre Nutzungsberichte zu aggregieren oder andere Arten von benutzerdefinierten Berichten zu generieren. **Topics** + [Erstellen Sie einen AWS Glue Crawler](configure-custom-reports-create-crawler.md) + [Erstellen Sie mithilfe des Crawlers einen Datenkatalog AWS Glue](configure-custom-reports-create-data-catalog.md) + [Erstellen und Ausführen von Athena-Abfragen](configure-custom-reports-create-run-athena-queries.md) + [Arbeiten mit Athena-Abfragen](configure-custom-reports-example-sql-queries.md) # Erstellen Sie einen AWS Glue Crawler AWS Glue ist ein vollständig verwalteter Service zum Extrahieren, Transformieren und Laden (ETL), mit dem Sie eine Datenbank aus Ihren Amazon S3 S3-Daten erstellen und diese Datenbank mithilfe von Athena abfragen können. Diese Datenbank wird auch als AWS Glue Datenkatalog bezeichnet. Ein AWS Glue Crawler kann das Schema Ihrer Amazon S3 S3-Daten automatisch erkennen und die entsprechende Datenbank und Tabellen erstellen. WorkSpaces Applications bietet eine CloudFormation Vorlage, mit der Sie die erforderlichen AWS Glue Ressourcen erstellen können. **Wichtig** Wenn Sie die Schritte im folgenden Verfahren ausführen, wird ein AWS Glue Crawler erstellt. Der Crawler wird damit jedoch nicht gestartet. Um den Crawler zu starten, müssen Sie die im nächsten Verfahren beschriebenen Schritte ausführen. Weitere Informationen zu AWS Glue Crawlern finden Sie unter Crawler [definieren](https://docs.aws.amazon.com/glue/latest/dg/add-crawler.html). **Um einen Crawler zu erstellen AWS Glue** 1. Öffnen Sie die WorkSpaces Anwendungskonsole zu [https://console.aws.amazon.com/appstream2/Hause](https://console.aws.amazon.com/appstream2/home). 1. Wählen Sie die AWS Region aus, für die Sie Nutzungsberichte abonniert haben. 1. Wählen Sie im Navigationsbereich die Option **Usage Reports (Nutzungsberichte)** und stellen Sie sicher, dass die Protokollierung von Nutzungsberichten aktiviert ist. 1. Wählen Sie auf der Registerkarte **Berichtsdetails** im Absatz neben **Analytics** den Link zur **CloudFormationVorlage** aus. Wenn Sie den Link auswählen, wird die CloudFormation Konsole geöffnet, in der Sie die Parameter des in der Vorlage angegebenen CloudFormation Stacks überprüfen können, bevor Sie sie ausführen. Wenn die Vorlage ausgeführt wird, erstellt sie einen AWS Glue Crawler und mehrere Athena-Beispielabfragen. 1. Behalten Sie auf der Seite „**Details angeben**“ neben **ScheduleExpression**entweder den Standardwert bei oder geben Sie einen anderen Cron-Ausdruckswert für die Häufigkeit an, mit der Sie den Crawler ausführen möchten. Ändern Sie keinen anderen Standardwert. Wählen Sie abschließend **Weiter**. Standardmäßig ist eine tägliche Ausführung des Crawlers festgelegt. Sie können den Crawler jedoch so konfigurieren, dass er wöchentlich, monatlich oder mit einer anderen Häufigkeit ausgeführt wird. Weitere Informationen zur Cron-Syntax finden Sie unter [Cron-Ausdrücke](https://docs.aws.amazon.com/AmazonCloudWatch/latest/events/ScheduledEvents.html#CronExpressions). 1. Behalten Sie auf der Seite **Options (Optionen)** die Standardwerte bei und wählen Sie **Next (Weiter)** aus. 1. **Aktivieren Sie auf der Seite „**Überprüfen**“ das Kontrollkästchen neben „Ich bestätige, dass CloudFormation möglicherweise IAM-Ressourcen mit benutzerdefinierten Namen erstellt werden“, und wählen Sie dann Erstellen aus.** Sie müssen über ausreichende AWS Glue und AWS Identity and Access Management (IAM-) Berechtigungen verfügen, um den Stack zu erstellen und auszuführen. CloudFormation Wenn Sie nicht über die erforderlichen Berechtigungen verfügen, bitten Sie Ihren AWS-Kontoadministrator, diese Schritte in Ihrem Konto auszuführen oder Ihnen die folgenden Berechtigungen zu erteilen. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "athena:CreateNamedQuery", "athena:BatchGetNamedQuery", "athena:GetNamedQuery", "athena:StartQueryExecution", "athena:GetQueryResults", "athena:GetQueryExecution", "athena:ListNamedQueries", "cloudformation:DescribeStacks", "cloudformation:GetStackPolicy", "cloudformation:DescribeStackEvents", "cloudformation:CreateStack", "cloudformation:GetTemplate", "cloudformation:ListChangeSets", "cloudformation:ListStackResources", "iam:GetRole", "iam:CreateRole", "iam:GetRolePolicy", "s3:GetBucketLocation", "s3:ListBucketMultipartUploads", "s3:ListBucket", "s3:ListMultipartUploadParts", "s3:PutObject", "s3:GetObject", "s3:AbortMultipartUpload" ], "Resource": [ "arn:aws:iam::*:role/AppStreamUsageReports-AppStreamUsageReportGlueRole*", "arn:aws:cloudformation:*:*:stack/AppStreamUsageReports/*", "arn:aws:athena:*:*:workgroup/primary", "arn:aws:s3:::aws-athena-query-results-*" ] }, { "Effect": "Allow", "Action": [ "iam:AttachRolePolicy", "iam:PutRolePolicy", "s3:GetObject", "s3:ListBucket" ], "Resource": [ "arn:aws:s3:::appstream-logs-*", "arn:aws:iam::*:role/AppStreamUsageReports-AppStreamUsageReportGlueRole*" ] }, { "Effect": "Allow", "Action": [ "iam:PassRole" ], "Resource": [ "arn:aws:iam::*:role/AppStreamUsageReports-AppStreamUsageReportGlueRole*" ], "Condition": { "StringEquals": { "iam:PassedToService": "glue.amazonaws.com" } } }, { "Effect": "Allow", "Action": [ "cloudformation:GetTemplateSummary", "glue:GetResourcePolicy", "glue:GetCrawlers", "glue:BatchGetCrawlers", "glue:GetClassifiers", "glue:CreateClassifier", "glue:ListCrawlers", "glue:GetTags", "glue:GetCrawlerMetrics", "glue:GetClassifier", "tag:GetResources" ], "Resource": "*" }, { "Effect": "Allow", "Action": "athena:RunQuery", "Resource": "arn:aws:athena:*:*:workgroup/primary" }, { "Effect": "Allow", "Action": [ "glue:GetTables", "glue:GetPartitions", "glue:GetTable" ], "Resource": [ "arn:aws:glue:*:*:table/appstream-usage/*", "arn:aws:glue:*:*:database/appstream-usage", "arn:aws:glue:*:*:catalog" ] }, { "Effect": "Allow", "Action": [ "glue:GetDatabase", "glue:CreateDatabase", "glue:GetDatabases" ], "Resource": [ "arn:aws:glue:*:*:database/appstream-usage", "arn:aws:glue:*:*:catalog" ] }, { "Effect": "Allow", "Action": [ "glue:GetCrawler", "glue:StartCrawler", "glue:CreateCrawler" ], "Resource": "arn:aws:glue:*:*:crawler/appstream-usage*" }, { "Effect": "Allow", "Action": "glue:GetCatalogImportStatus", "Resource": "arn:aws:glue:*:*:catalog" } ] } ``` ------ # Erstellen Sie mithilfe des Crawlers einen Datenkatalog AWS Glue Wenn der AWS Glue Crawler ausgeführt wird, erstellt er einen Datenkatalog und ein Schema, die der Struktur Ihrer Sitzungen und Anwendungsberichte zugeordnet sind. Jedes Mal, wenn ein neuer Bericht in Ihrem Amazon S3 S3-Bucket gespeichert wird, müssen Sie den Crawler ausführen, um Ihren AWS Glue Datenkatalog mit den Daten aus dem neuen Bericht zu aktualisieren. **Anmerkung** Für den Betrieb Ihres AWS Glue Crawlers können Gebühren anfallen. Weitere Informationen finden Sie unter [AWS Glue  – Preise](https://aws.amazon.com/glue/pricing/). 1. Öffnen Sie die AWS Glue Konsole unter. [https://console.aws.amazon.com/glue/](https://console.aws.amazon.com/glue/) 1. Wählen Sie die AWS Region aus, für die Sie Nutzungsberichte abonniert haben. 1. Aktivieren Sie das Kontrollkästchen neben dem Crawler mit dem Namen **appstream-usage-sessions-crawler**und wählen Sie dann Crawler **ausführen** aus. Wiederholen Sie diesen Schritt für den genannten Crawler. **appstream-usage-apps-crawler** Durch die Ausführung dieser Schritte werden die Crawler ausgeführt und so geplant, dass sie automatisch gemäß dem im Stack angegebenen Zeitplan ausgeführt werden. CloudFormation 1. Wenn die Ausführung beider Crawler abgeschlossen ist, klicken Sie im Navigationsbereich auf **Databases (Datenbanken)**. Es wird eine Datenbank mit dem Namen **appstream-usage** angezeigt, die Ihre Nutzungsberichte darstellt. Bei dieser Datenbank handelt es sich um einen AWS Glue Datenkatalog, der erstellt wurde **appstream-usage-sessions-crawler**und ausgeführt **appstream-usage-apps-crawler**wurde. 1. Um die Tabellen in der Datenbank anzuzeigen, wählen Sie **appstream-usage**, **Tables (Tabellen)** aus. Es werden zwei Tabellen angezeigt: **applications (Anwendungen)** und **sessions (Sitzungen)**. Diese stellen Ihre Nutzungsberichte zu Anwendungen bzw. Sitzungen dar. Klicken Sie auf eine Tabelle, um ihr Schema anzuzeigen. Sie können diese Tabellen jetzt mithilfe von SQL in Athena abfragen. # Erstellen und Ausführen von Athena-Abfragen Führen Sie die folgenden Schritte aus, um Ihre Nutzungsberichte mithilfe von Athena abzufragen. **Anmerkung** Für Athena-Abfragen fallen möglicherweise Gebühren an. Weitere Informationen hierzu finden Sie unter [Preise zu Amazon Athena](https://aws.amazon.com/athena/pricing/). 1. Öffnen Sie die Athena-Konsole unter [https://console.aws.amazon.com/athena/](https://console.aws.amazon.com/athena/home). 1. Wählen Sie unter **Database (Datenbank)** die Option **appstream-usage**. 1. Geben Sie im Abfragebereich eine SQL-Abfrage ein und klicken Sie auf **Run query (Abfrage ausführen)**. # Arbeiten mit Athena-Abfragen Dieser Abschnitt stellt SQL-Abfragen bereit, die Sie in Athena ausführen können, um die Nutzungsberichte in Ihrem Amazon-S3-Bucket zu analysieren. Um einen konsolidierten Bericht zu allen Sitzungen in einem bestimmten Monat zu erstellen, führen Sie die folgende Abfrage aus: ``` SELECT * FROM "appstream-usage"."sessions" WHERE year='four-digit-year' AND month='two-digit-month' ``` Sie können auch Join-Vorgänge zwischen den Tabellen **applications (Anwendungen) **und **sessions (Sitzungen)** in Ihrer Abfrage ausführen. Beispiel: Führen Sie die folgende Abfrage aus, um die verschiedenen Benutzer anzuzeigen, die die einzelnen Anwendungen in einem bestimmten Monat gestartet haben: ``` SELECT DISTINCT apps.application_name, sessions.user_id FROM "appstream-usage"."applications" apps INNER JOIN "appstream-usage"."sessions" sessions ON (apps.user_session_id = sessions.user_session_id AND sessions.year='four-digit-year' AND sessions.month='two-digit-month') WHERE apps.year='four-digit-year' AND apps.month='two-digit-month' ORDER BY 1, 2 ``` Die Ergebnisse von Athena-Abfragen werden als CSV-Dateien in einem Amazon-S3-Bucket in Ihrem Konto mit der Bezeichnung `aws-athena-query-results-account-id-without-hyphens-region-code` gespeichert. Damit Sie Abfrageergebnisse einfach finden können, wählen Sie **Save as (Speichern unter)** und geben Sie einen Namen für Ihre Abfrage ein, bevor Sie sie ausführen. Sie können auch auf das Download-Symbol im Bereich **Athena-Ergebnisse** klicken, um die Ergebnisse der Abfrage in einer CSV-Datei herunterzuladen. Um die Leistung zu verbessern und die Kosten zu senken, reduziert Athena die Menge der in Abfragen überprüften Daten mithilfe der Partitionierung. Weitere Informationen finden Sie auf der Seite zum [Partitionieren von Daten](https://docs.aws.amazon.com/athena/latest/ug/partitions.html). Nutzungsberichte werden in Ihren Amazon-S3-Buckets nach Jahr, Monat und Tag partitioniert. Sie können Ihre Abfragen auf bestimmte Partitionen von Datumsbereichen eingrenzen. Verwenden Sie dazu die Felder **year (Jahr)**,** month (Monat)** und **day (Tag)** als Bedingungen für Ihre Abfragen. Beispiel: Die folgende Abfrage erfasst nur die Sitzungsberichte für die Woche ab dem 19. Mai 2019. ``` SELECT SUBSTRING(session_start_time, 1, 10) AS report_date, COUNT(DISTINCT user_session_id) AS num_sessions FROM "appstream-usage"."sessions" WHERE year='2019' AND month='05' AND day BETWEEN '19' and '25' GROUP BY 1 ORDER BY 1 ``` Im Gegensatz dazu erzeugt die folgende Abfrage identische Ergebnisse. Da sie jedoch nicht auf Partitionen begrenzt ist, erfasst sie alle in Ihrem Amazon-S3-Bucket gespeicherten Sitzungsberichte. ``` SELECT SUBSTRING(session_start_time, 1, 10) AS report_date, COUNT(DISTINCT user_session_id) AS num_sessions FROM "appstream-usage"."sessions" WHERE session_end_time BETWEEN '2019-05-19' AND '2019-05-26' GROUP BY 1 ORDER BY 1 ``` Wenn eine Sitzung mehrere Tage umfasst, werden die Datensätze zur Sitzung und zur Anwendung in den Sitzungs- und Anwendungsberichten zu dem Tag angezeigt, in dem die Sitzung endete. Wenn Sie Datensätze zu allen Sitzungen finden müssen, die während eines bestimmten Datumsbereichs aktiv waren, empfehlen wir daher, den Partitionssatz Ihrer Abfrage um die maximale Sitzungsdauer zu erweitern, die Sie für Ihre Flotten konfiguriert haben. Beispiel: Wenn Sie alle Sitzungen anzeigen möchten, die für eine bestimmte Flotte während eines Kalendermonats aktiv waren und die Flotte eine maximale Sitzungsdauer von 100 Stunden hatte, führen Sie die folgende Abfrage aus, um Ihren Partitionssatz um fünf Tage zu erweitern. ``` SELECT * FROM "appstream-usage"."sessions" WHERE fleet_name = 'fleet_name' AND session_start_time BETWEEN '2019-05-01' AND '2019-06-01' AND year='2019' AND (month='05' OR (month='06' AND day<='05')) ORDER BY session_start_time ``` Die CloudFormation Vorlage, mit der die AWS Glue Crawler erstellt wurden, hat auch mehrere Beispielabfragen in Ihrem Athena-Konto erstellt und gespeichert, mit denen Sie Ihre Nutzungsdaten analysieren können. Zu diesen Beispielabfragen gehören: + Aggregierte monatliche Sitzungsberichte + Durchschnittliche Sitzungsdauer pro Stack + Anzahl der Sitzungen pro Tag + Gesamtzahl der Streaming-Stunden pro Benutzer **Anmerkung** On-Demand-Nutzungsgebühren werden für jede Sitzung auf die nächste Stunde aufgerundet. + Verschiedene Benutzer pro App Führen Sie die folgenden Schritte aus, um eine dieser Abfragen zu verwenden. 1. Öffnen Sie die Athena-Konsole unter [https://console.aws.amazon.com/athena/](https://console.aws.amazon.com/athena/). 1. Wählen Sie **Saved Queries (Gespeicherte Abfragen)**. Die fünf vor diesem Verfahren erwähnten Abfragen sollten angezeigt werden. Der Name jeder Abfrage beginnt mit "AS2.“ Zum Beispiel „AS2\$1users\$1per\$1app\$1curr\$1mo“. 1. Um eine Abfrage auszuführen, wählen Sie den Abfragenamen anstatt der Option neben dem Namen aus. 1. Der Text der Abfrage wird im Abfragebereich angezeigt. Wählen Sie **Abfrage ausführen**. [https://docs.aws.amazon.com/code-samples/latest/catalog/cloudformation-appstream2-athena-sample-queries-appstream-usage-data_template.yml.html](https://docs.aws.amazon.com/code-samples/latest/catalog/cloudformation-appstream2-athena-sample-queries-appstream-usage-data_template.yml.html)