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. # Telemetrie einrichten Gehen Sie wie folgt vor, um die Telemetrie für Ihre AWS Ground Station Kontakte zu konfigurieren. Nach Abschluss dieser Einrichtung werden Telemetriedaten bei Kontakten, die ein telemetriefähiges Missionsprofil verwenden, an Ihren Kinesis Data Streams Streams-Stream übermittelt. Ein detailliertes Verständnis von Kinesis Data Streams finden Sie im [Kinesis Data Streams Streams-Benutzerhandbuch](https://docs.aws.amazon.com/streams/latest/dev/introduction.html). ## Schritt 1: Erstellen Sie die erforderlichen Ressourcen AWS Der folgende CloudFormation Ausschnitt zeigt, wie Sie die erforderlichen AWS Ressourcen für die Telemetriebereitstellung erstellen. Dieses Snippet erstellt einen Kinesis Data Streams Streams-Stream und eine IAM-Rolle, die die AWS Ground Station Erlaubnis erteilt, Telemetriedaten in den Stream zu schreiben. ``` {{TelemetryStream}}: Type: AWS::Kinesis::Stream Properties: Name: {{GroundStationTelemetryStream}} StreamModeDetails: StreamMode: {{ON_DEMAND}} RetentionPeriodHours: {{24}} {{TelemetryRole}}: Type: AWS::IAM::Role Properties: RoleName: {{GroundStationTelemetryRole}} AssumeRolePolicyDocument: Version: '2012-10-17' Statement: - Effect: Allow Principal: Service: groundstation.amazonaws.com Action: sts:AssumeRole Policies: - PolicyName: {{KinesisWritePolicy}} PolicyDocument: Version: '2012-10-17' Statement: - Effect: Allow Action: - kinesis:DescribeStream - kinesis:PutRecord - kinesis:PutRecords Resource: !GetAtt {{TelemetryStream}}.Arn ``` In der folgenden Liste werden spezielle Überlegungen zur Einrichtung bei der Konfiguration der Telemetriebereitstellung für aufgeführt. AWS Ground Station **Kinesis Data Streams Streams-Stream — Der Stream** verwendet den On-Demand-Kapazitätsmodus, der automatisch auf der Grundlage des Durchsatzes skaliert wird. Dies wird für die meisten Anwendungsfälle empfohlen. Der Stream ist so konfiguriert, dass er Daten 24 Stunden lang aufbewahrt. Standardmäßig verwendet der Stream AWS verwaltete Verschlüsselung. Um die vom Kunden verwaltete Verschlüsselung mit zu verwenden AWS Key Management Service, fügen Sie die `StreamEncryption` Eigenschaft hinzu und aktualisieren Sie die IAM-Rollenrichtlinie, sodass sie auch Berechtigungen enthält`kms:GenerateDataKey`. Weitere Informationen finden Sie unter [Datenschutz in Amazon Kinesis Data Streams](https://docs.aws.amazon.com/streams/latest/dev/server-side-encryption.html). **IAM-Rolle** — Die IAM-Rolle ermöglicht es dem `groundstation.amazonaws.com` Service Principal, die Rolle zu übernehmen und Telemetriedaten in Ihren Kinesis Data Streams Streams-Stream zu schreiben. Die Rollenrichtlinie gewährt Berechtigungen für `kinesis:DescribeStream``kinesis:PutRecord`, und `kinesis:PutRecords` Aktionen im Stream. Anleitungen [Telemetrie Sink Config](how-it-works.config.md#how-it-works.config-telemetry-sink) zur Einrichtung der Vertrauens- und Rollenrichtlinie finden Sie unter. **Zusätzliche Konfiguration** — Fügen Sie dem IAM-Benutzer oder der IAM-Rolle, die Sie für AWS Ground Station API-Aufrufe verwenden, `iam:PassRole` Berechtigungen hinzu. Auf diese Weise können Sie die Telemetriefunktion AWS Ground Station beim Erstellen eines übergeben. TelemetrySinkConfig ### Beispiel für PassRole eine Richtlinie Weitere Informationen zum Aktualisieren oder Anhängen einer Rollenrichtlinie finden Sie unter [Verwaltung von IAM-Richtlinien](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_manage.html) im IAM-Benutzerhandbuch. Weitere Informationen zur `iam:PassRole` Berechtigung finden Sie unter [Erteilen von Benutzerberechtigungen zur Übergabe einer Rolle an einen AWS-Service](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_use_passrole.html) ``` { "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "iam:GetRole", "iam:PassRole" ], "Resource": "arn:aws:iam::{{999999999999}}:role/{{your-telemetry-delivery-role-name}}" } ] } ``` ## Schritt 2: Erstellen Sie ein TelemetrySinkConfig Erstellen Sie eine *TelemetrySinkConfig*, die definiert, wie AWS Ground Station Telemetriedaten an Ihren Kinesis Data Streams Streams-Stream geliefert werden. Verwenden Sie den Stream-ARN und den Rollen-ARN aus den CloudFormation Stack-Ausgaben in Schritt 1. **Anmerkung** Wenn Sie einen erstellen *TelemetrySinkConfig*, AWS Ground Station wird der Zugriff auf Ihren Kinesis Data Streams Streams-Stream überprüft, indem ein leerer Testdatensatz mit dem Partitionsschlüssel von `test` bereitgestellt wird. Weitere Informationen zum Erstellen eines finden Sie *TelemetrySinkConfig*unter[Telemetrie Sink Config](how-it-works.config.md#how-it-works.config-telemetry-sink). ## Schritt 3: Fügen Sie Ihrem Missionsprofil Telemetrie hinzu Erstellen Sie ein Missionsprofil. Weitere Informationen zum Erstellen von Missionsprofilen finden Sie unter[AWS Ground Station Missionsprofile verwenden](how-it-works-mission-profile.md). Fügen Sie das `telemetrySinkConfigArn` zu Ihrem Missionsprofil hinzu, um die Telemetrieübertragung bei Kontakten zu aktivieren. Verwenden Sie den in Schritt 2 *TelemetrySinkConfig*erstellten ARN. ## Schritt 4: Einen Kontakt vereinbaren Planen Sie einen Kontakt mithilfe Ihres telemetriefähigen Missionsprofils. Während des Kontakts AWS Ground Station werden Telemetriedaten in Ihren Kinesis Data Streams-Stream gestreamt. **Was ist bei Kontakten zu erwarten** + **Telemetriestart** — Die Daten werden gestreamt, sobald der Kontakt beginnt. + **Lieferung nahezu in Echtzeit** — Telemetrie geht nahezu in Echtzeit in Ihren Kinesis Data Streams Streams-Stream ein. + **Kontaktdauer — Die** Daten bleiben während des gesamten Kontakts erhalten. + **Automatischer Stopp** — Die Telemetrie stoppt das Streaming, wenn der Kontakt endet. **Überwachung der Lieferung** Sie können die Telemetrieübertragung wie folgt überwachen: + **Kinesis Data Streams Streams-Streams-Streams-Metriken** — Checken Sie eingehende Datensätze ein. CloudWatch Weitere Informationen finden Sie unter [Amazon Kinesis Data Streams überwachen](https://docs.aws.amazon.com/streams/latest/dev/monitoring-with-cloudwatch.html). + **Anwendungsprotokolle** — Überprüfen Sie die Datenverarbeitung in Ihren Anwendungen, die Daten aus dem Stream verarbeiten. + **Kinesis Data Viewer** — Verwenden Sie die Kinesis Data Streams Streams-Stream-Konsole, um Beispieldatensätze aus Ihrem Stream anzuzeigen. ## Nächste Schritte Nach Abschluss der Einrichtung können Sie: + Erfahren Sie mehr über das Telemetriedatenformat und die verfügbaren Telemetriearten. Siehe [Verstehen Sie Telemetriedaten](telemetry.understanding-data.md). + Erstellen Sie Anwendungen zur Verarbeitung von Telemetriedaten aus Ihrem Kinesis Data Streams Streams-Stream. Weitere Informationen finden Sie unter [Building Consumers for Amazon Kinesis Data Streams](https://docs.aws.amazon.com/streams/latest/dev/building-consumers.html). + Erstellen Sie Dashboards und Benachrichtigungen mithilfe von CloudWatch und anderen AWS Diensten. + Lesen Sie die Anleitungen zur Fehlerbehebung, falls Sie auf Probleme stoßen. Siehe [Fehlerbehebung bei Telemetrie](troubleshooting-telemetry.md).