Integration mit Kafka Connector

Automatisieren Sie den Stream von Samsara-Live-Betriebsdaten in einen Kafka-Cluster, um in Echtzeit Apps zu betreiben und Ihr Data Warehouse zu füllen.

Der Kafka-Producer von Samsara Support die folgenden Anwendungsfälle:

GPS-Standorte von Fahrzeugen, Anhängern, Ausrüstung und Asset-Tags
Fahrzeugdiagnose, einschließlich Kilometerzähler, Maschinenstunden, Fehlercodes, Kraftstoffstände und mehr
Ereignisse, einschließlich Benachrichtigungsereignisse, schwere Geschwindigkeitsüberschreitung, Geofence-Eintritt und -Austritt, Dokument eingereicht und mehr

Für die Nutzdaten jeder Dateneinheit siehe Kafka Connector Reference.

Anforderungen

Kafka: Kafka 0.10.1.0 oder eine spätere Version.
Samsara: Datenstreaming-Zugriff über Ihre Plattform-Lizenz

Einige Einheiten benötigen Lizenzen in Telematik und Sicherheitsdaten, damit die Daten zum Stream verfügbar sind. Zum Beispiel ist eine AG-Lizenz erforderlich, um GPS von Geräten zu streamen.

Sicherheitsüberlegungen

Ihr IT-Team benötigt möglicherweise die Genehmigung von Ihrem internen Sicherheitsteam, um einem externen Anbieter wie Samsara zu erlauben, in Ihren Kafka-Cluster zu schreiben. Beachten Sie außerdem Folgendes:

Der Kafka-Connector erfordert einen öffentlichen Endpunkt zu allen Brokern in Ihrem Kafka-Cluster.
Samsara erfordert die minimalen Berechtigungen, um ein Kafka-Thema zu erstellen:

Wir empfehlen, dass Sie nur die minimalen Berechtigungen zum SCHREIBEN und BESCHREIBEN für das spezifische Thema an die Authentifizierungsdaten gewähren.

Samsara verschlüsselt Geheimnisse, wenn es mit Ihrem Kafka-Cluster verbunden ist.
Samsara Kafka-Connector-Anfragen werden von einem statischen Satz von IP-Adressen gesendet.

Wenn Sie den Zugriff auf Ihren Kafka-Cluster nach Quell-IP einschränken möchten, müssen Sie die IP-Adressen von Samsara zu Ihrer Erlaubnisliste hinzufügen.

Um die Liste der IP-Adressen zu erhalten, melden Sie sich bei Ihrem Samsara-Dashboard an und navigieren Sie zu Einstellungen ( ) > Webhooks.

Implementierung

Samsara hat den Kafka Connector entwickelt und wird bei Bedarf bei Implementierungen unterstützen. Befolgen Sie die folgenden Schritte, um zu beginnen. Wenn es irgendwelche Probleme gibt, kontaktieren Sie bitte den Samsara Support.

Richten Sie die Kafka-Einstellungen ein.

Wenn Sie noch keinen Kafka-Cluster haben, wählen Sie eine Cloud-Plattform Ihrer Wahl, um einen zu implementieren. Es gibt mehrere Optionen, die Sie verwenden können. Schauen Sie in unserem Datenverbindungshandbuch nach, um eine Liste der Optionen zu sehen und mehr zu erfahren.

Die verbleibenden Schritte zur Verbindung des Samsara Kafka-Producers mit Ihrem Kafka-Cluster werden über die Confluent-Cloud-Plattform veranschaulicht.
Erstellen Sie ein Thema in Ihrem Confluent Kafka-Cluster, um Daten von Samsara zu empfangen.

Wenn Ihr Kafka-Cluster von außerhalb Ihres Netzwerks nicht zugänglich ist, stellen Sie sicher, dass Sie:
1. Erlauben Sie eingehende Verbindungen zu allen Brokern für den Samsara Kafka Connector.
  
  Um die Liste der IP-Adressen zu erhalten, melden Sie sich bei Ihrem Samsara-Dashboard an und navigieren Sie zu Einstellungen ( ) > Webhooks.
2. Konfigurieren Sie beworbene Listener auf extern auflösbare Adressen oder Hostnamen. Weitere Informationen finden Sie in der Confluent-Dokumentation zu Kafka-Listenern.
Konfigurieren Sie einen SASL/PLAIN-Benutzer auf dem Broker.

Siehe Schritte 1-3 in der Konfigurationsdokumentation zu Kafka Listeners.

Sie müssen SASL SSL konfigurieren und nicht SASL PLAIN Text.
Gewähren Sie dem Benutzer ACLS-Schreibzugriff und definieren Sie den Zugriff auf das neue Thema.

Für Ihren spezifischen Themennamen gewähren Sie die gleichen Berechtigungen, Operationen und Musterarten wie gezeigt, und dann klicken Sie auf Weiter.
Notieren Sie den Schlüssel und das Geheimnis für die zukünftige Verwendung im Samsara-Dashboard.
Richten Sie den Kafka-Connector über das Samsara-Dashboard in den Einstellungen ein.
1. Navigieren Sie zu Einstellungen ( ) > Daten-Stream.
2. Wählen Sie Verbundene Cluster aus.
3. Klicken Sie auf + Verbindung erstellen.
4. Geben Sie die folgenden Informationen ein, die von Ihrem Kafka-Cluster generiert wurden:
  - URL: Sie können die URL in den Cluster-Einstellungen unter Bootstrap-Server finden. Dieser Standort kann unterschiedlich sein, wenn der Benutzer Confluent nicht verwendet.
  - SASL-Mechanismus: Wählen Sie SASL/PLAIN basierend auf Ihren Confluent-Einstellungen.
  - Schlüssel: Dieses Feld ist der Schlüssel (Kafka SASL-Benutzername), den Confluent generiert hat, als Sie den Themenzugriff wie im vorherigen Schritt beschrieben in den Einstellungen eingerichtet haben.
  - Geheimnis: Dieses Feld ist das Geheimnis (Kafka SASL-Passwort), das Confluent generiert hat, als Sie den Zugriff auf das Thema wie im vorherigen Schritt beschrieben in den Einstellungen eingerichtet haben.
  - Clustername: Geben Sie einen Namen an, um Ihren authentifizierten Cluster bei der Einrichtung von Datenstreams leicht zu identifizieren.
5. Klicken Sie auf + Speichern, wenn Sie fertig sind.
  
  Wenn die Konfiguration erfolgreich ist, zeigt Samsara eine Benachrichtigung Erfolgreich erstelltes Kafka-Abonnement an. Die Initialisierung des Connector-Streams wird einige Minuten in Anspruch nehmen.
6. Wählen Sie Streams.
7. Klicken Sie auf + Stream erstellen und geben Sie die folgenden Informationen ein:
  - Verbundener Cluster: Wählen Sie einen verbundenen Kafka-Cluster mit dem vorgesehenen Zielthema aus.
  - Themenname: Stimmen Sie den Themenname in Ihrem verbundenen Cluster mit dem Ziel dieses Abonnement-Streams ab.
  - Entitäten: Wählen Sie eine oder mehrere Datenentitäten aus, um sie zu einem verbundenen Cluster zu streamen. Jede ausgewählte Entität wird ein einzigartiger Stream sein.
8. Klicken Sie auf + Streams erstellen, wenn Sie fertig sind.