Gérer Kafka flux de données

Autorisations requises : Data Streams

Cette page vous aide à configurer et à vous abonner à un flux de données Kafka. CXone Mpower fournit des journaux IVRFermé Interactive Voice Response. Automated phone menu contacts use via voice or key inputs to obtain information, route an inbound voice call, or both. sous forme de flux, vous devez donc configurer une méthode de consommation des données à une destination que vous contrôlez. Une configuration complète comprend les étapes de configuration de CXone Mpower ainsi que la configuration du service ou du système qui s'abonnera au flux et le consommera.

Lors de la configuration du flux dans CXone Mpower, vous pouvez choisir de consommer les données dans les formats de schéma suivants :

  • PROTO
  • JSON
  • AVRO
  • JSON avec saut de ligne
  • JSON AVRO avec saut de ligne

Configurer un flux de données Kafka

Tout d’abord, planifiez la manière dont vous utiliserez le flux Kafka. Vous devez disposer des ressources techniques pour créer une destination pouvant s'abonner au flux. Cela nécessite que vous répondiez aux exigences de sécurité :

  • Fournir les CIDR IPv4 que vous souhaitez utiliser pour accéder aux sujets Kafka. Cela garantit CXone Mpower que vos adresses IP sont légitimes et autorisées. Vous pouvez ajouter deux CIDR IP à la fois.

  • Une méthode d'authentification pour utiliser les informations d'identification du nom d'utilisateur et du mot de passe de CXone Mpower.

Créer un flux de données Kafka dans CXone Mpower

Les instructions suivantes vous aident à créer un flux de données, à générer un ensemble d’informations d’identification et à ajouter les CIDR IP que vous utiliserez pour vous abonner au flux de données.

  1. Cliquez sur le sélecteur d'applications icône du sélecteur d'applications et sélectionnez Admin.
  2. Allez à Paramètres du compte > Flux de données d'événement.

  3. Cliquez sur Créer un nouveau flux de données.

  4. Saisissez le Nom du flux de données et éventuellement une Description.

  5. Sélectionnez Journal IVR comme Type d'événement.

  6. Pour Format de données, choisissez le format de schéma dans lequel vous souhaitez que les données soient.

  7. Pour Type de flux cible, sélectionnez Kafka externe.

  8. Générer un ensemble d’informations d’identification. Il s'agit du nom d'utilisateur et du mot de passe que vous pouvez utiliser pour vous abonner au flux Kafka.

    1. Cliquez sur Gérer dans la section Sécurité de la page Nouveau flux de données ; une fenêtre du gestionnaire de sécurité s'ouvre.

    2. Pour Alias, saisissez un nom unique pour l'ensemble d'informations d'identification. Vous devez saisir au moins six caractères alphanumériques. Les seuls caractères spéciaux autorisés sont un tiret (-) ou un trait de soulignement (_).

      Vous ne pouvez créer que deux ensembles d'informations d'identification pour un flux de données à la fois. Si nécessaire, vous pouvez supprimer un ensemble d'informations d'identification puis en créer un nouveau.

    3. Cliquez sur Créer et télécharger. Cela télécharge le nom d'utilisateur et le mot de passe sous forme de fichier CSV.

  9. Dans la même fenêtre du gestionnaire de sécurité, faites défiler vers le bas et entrez les CIDR IP que vous souhaitez utiliser pour le flux de données :

    1. Faites défiler jusqu'à la section CIDR IP autorisés.

    2. Pour IP CIDR, saisissez le CIDR complet des adresses IP via lesquelles vous souhaitez vous abonner. Assurez-vous d’inclure à la fois l’adresse IP et le masque de sous-réseau pour l’adresse CIDR complète. Vous pouvez saisir plusieurs CIDR à la fois, séparés par une virgule.

      • Vous ne pouvez avoir que deux ensembles de CIDR IP pour un flux de données à la fois. Vous pouvez supprimer une IP CIDR si nécessaire.
      • Data Streams prend actuellement en charge IPv4.
      • La plage maximale autorisée est comprise entre /24 et /32.

    3. Cliquez sur OK.

  10. Cliquez sur Créer.

Après avoir créé le flux de données, les détails du flux s'affichent en bas. Cela inclut les détails du courtier, l'ID du groupe de consommateurs et le nom du sujet. Vous pouvez les utiliser pour configurer votre service ou système qui consommera les données.

De plus, le flux de données devient généralement actif immédiatement après sa création. Au maximum, cela peut prendre 15 à 30 minutes.

Configurer une destination pour s'abonner au flux Kafka

Dans votre propre Kafka destination , vous devez insérer les détails du courtier de flux que vous avez générés dans la section précédente. Votre équipe technique doit utiliser son expertise pour y parvenir.

Supprimer les informations d'identification Kafka

Pour des raisons de sécurité, vous souhaiterez peut-être ou devrez peut-être remplacer un ensemble d'informations d'identification. Dans CXone Mpower, vous avez la possibilité de supprimer de manière logicielle ou définitive un ensemble d'informations d'identification. La suppression logicielle signifie que les informations d'identification deviennent inactives pendant deux jours, après quoi elles sont complètement supprimées. Cela vous laisse le temps de générer un ensemble de nouvelles informations d'identification et de les implémenter pour votre abonnement Kafka. Une suppression définitive est une suppression immédiate.

  1. Cliquez sur le sélecteur d'applications icône du sélecteur d'applications et sélectionnez Admin.
  2. Allez à Paramètres du compte > Flux de données d'événement.
  3. Sélectionnez le flux de données souhaité.
  4. Dans la section Sécurité où vos alias d'informations d'identification sont répertoriés, cliquez sur Gérer.
  5. Cliquez sur l’icône Supprimer dans la colonne Action pour les informations d’identification que vous souhaitez supprimer. Une notification de confirmation apparaît.
  6. Choisissez si vous souhaitez supprimer les informations d'identification de manière logicielle ou définitive :
    • Pour supprimer de manière réversible, confirmez la suppression. L'icône d'état devient jaune. Après deux jours, les informations d’identification seront définitivement supprimées.
    • Pour supprimer définitivement, cochez la case pour supprimer immédiatement les informations d'identification, puis confirmez la suppression.

Résoudre les problèmes avec Kafka Data Streams

Si votre abonnement au flux de données ne fonctionne pas correctement, vérifiez les points suivants :

  • Vous avez saisi les informations correctes du courtier dans le système abonné au flux. Vous pouvez les trouver dans CXone Mpower dans la section Détails du flux des détails du flux de données.

  • Les détails du flux de données pour garantir que vous avez saisi les CIDR IPv4 corrects. Assurez-vous que ces adresses IP sont également affichées comme Actives dans l'interface CXone Mpower.

  • Que les informations d’identification sont correctes dans le système consommant le flux de données.