Integratie met Kafka Connector

Stream automatisch Samsara live-operatiegegevens naar een Kafka-cluster om real-time apps aan te drijven en uw datawarehouse te vullen.

De Kafka-producent van Samsara biedt ondersteuning voor de volgende gebruiksscenario's:

GPS-locaties van voertuigen, aanhangwagens, apparatuur en asset tags
Voertuigdiagnostiek, inclusief kilometerteller, motoruren, foutcodes, brandstofniveaus en meer
Gebeurtenissen, inclusief waarschuwing incidenten, ernstige snelheidsovertreding, geofence binnenkomst en vertrek, ingediende gebeurtenis, en meer

Voor de payload van berichten voor elke gegevensentiteit, zie Kafka Connector Reference.

Vereisten

Kafka: Kafka 0.10.1.0 of een latere release.
Samsara: Toegang tot datastreaming via uw Platformlicentie

Sommige entiteiten vereisen licenties in telematica en veiligheidsgegevens om de gegevens beschikbaar te maken voor een stream. Bijvoorbeeld, een AG-licentie is vereist om de GPS van apparatuur te streamen.

Beveiligingsoverwegingen

Uw IT-team heeft mogelijk goedkeuring nodig van uw interne beveiligingsteam om een externe producent zoals Samsara toe te staan om naar uw Kafka-cluster te schrijven. Let daarnaast op het volgende:

De Kafka-connector vereist een openbaar eindpunt voor alle brokers in uw Kafka-cluster.
Samsara vereist de minimale set van machtigingen om een Kafka-onderwerp te produceren:

We raden aan om alleen de minimale machtigingen voor SCHRIJVEN en BESCHRIJVEN voor het specifieke onderwerp aan de authenticatiegegevens toe te kennen.

Samsara versleutelt geheimen wanneer het is verbonden met je Kafka-cluster.
Samsara Kafka-connectorverzoeken worden verzonden vanaf een statische set IP-adressen.

Als u de toegang tot uw Kafka-cluster wilt beperken op basis van bron-IP, moet u Samsara's IP-adressen toevoegen aan uw toestemmingslijst.

Om de lijst met IP-adressen te verkrijgen, log in op het Samsara dashboard en navigeer naar Instellingen ( ) > Webhooks.

Implementatie

Samsara heeft de Kafka Connector gebouwd en zal indien nodig helpen met implementaties. Volg de onderstaande stappen om te beginnen. Als er problemen zijn, neem dan contact op met Samsara Support.

Stel de Kafka-cluster in.

Als u nog geen Kafka-cluster hebt, selecteer dan een cloud Platform naar keuze om er een te implementeren. Er zijn verschillende opties die u kunt gebruiken. Raadpleeg onze Data Connector-gids om een lijst met opties te bekijken en meer te leren.

De resterende stappen om de Samsara Kafka-producer met uw Kafka-cluster te verbinden, worden geïllustreerd via het Confluent cloud Platform.
Maak een onderwerp in uw Confluent Kafka-cluster om gegevens van Samsara te ontvangen.

Als uw Kafka-cluster niet toegankelijk is van buiten uw netwerk, zorg er dan voor dat u:
1. Sta inkomende verbindingen toe naar alle brokers voor de Samsara Kafka Connector.
  
  Om de lijst met IP-adressen te verkrijgen, log in op het Samsara dashboard en navigeer naar Instellingen ( ) > Webhooks.
2. Configureer geadverteerde luisteraars naar extern oplosbare adressen of hostnamen. Voor meer informatie, zie de Confluent-documentatie over Kafka-luisteraars.
Configureer een SASL/PLAIN-gebruiker op de broker.

Zie stappen 1-3 in de configuratiedocumentatie over Kafka Listeners.

U moet SASL SSL configureren, en niet SASL PLAIN tekst.
Geef de gebruiker ACLS schrijfrechten en definieer toegang tot het nieuwe onderwerp.

Voor uw specifieke Onderwerpnaam, verleen dezelfde Toestemming, Operatie, en Patterntypen zoals getoond, en klik dan op Volgende.
Noteer de sleutel en het geheim voor toekomstig gebruik in de Samsara dashboard.
Vanuit de Samsara dashboard, stel de Kafka Connector in.
1. Navigeer naar Instellingen ( ) > Gegevensstreaming.
2. Selecteer Verbonden clusters.
3. Klik + Verbinding maken.
4. Voer de volgende informatie in die is gegenereerd door uw Kafka-cluster:
  - URL: U kunt de URL vinden in de Clusterinstellingen onder Bootstrap-server. Deze locatie kan anders zijn als de gebruiker geen gebruik maakt van Confluent.
  - SASL-mechanisme: Selecteer SASL/PLAIN op basis van uw Confluent-instellingen.
  - Sleutel: Dit veld is de Sleutel (Kafka SASL-gebruikersnaam) die Confluent heeft gegenereerd toen u toegang tot het onderwerp instelde zoals beschreven in de vorige stap.
  - Geheim: Dit veld is het Geheim (Kafka SASL-wachtwoord) dat Confluent heeft gegenereerd toen u toegang tot het onderwerp instelde zoals beschreven in de vorige stap.
  - Clustenaam: Geef een naam op om uw geauthenticeerde cluster gemakkelijk te identificeren bij het instellen van datastreams
5. Klik + Opslaan wanneer u klaar bent.
  
  Als de configuratie succesvol is, toont Samsara een melding Succesvol Kafka-abonnement aangemaakt. De initialisatie van de connector stream zal enkele minuten duren om te voltooien.
6. Selecteer Streams.
7. Klik + Stream maken en voer de volgende informatie in:
  - Verbonden cluster: Selecteer een verbonden Kafka-cluster met de beoogde topicbestemming.
  - Onderwerpnaam: Stem de Onderwerpnaam af in uw verbonden cluster voor de bestemming van deze abonnementsstream.
  - Entiteiten: Selecteer een of meer gegevensentiteiten om naar een verbonden cluster te streamen. Elke geselecteerde entiteit zal een unieke stream zijn.
8. Klik + Streams maken wanneer u klaar bent.