Kafkaデータストリームの管理

必要な権限:Data Streams

このページは、Kafkaデータストリームの設定と購読に役立ちます。 CXone Mpower は IVRClosed 音声応答システム(IVR)。 音声またはキー入力を使用して情報を取得したり、着信音声通話を振り分けたりする自動化された電話メニュー。 ログをストリームとして提供するため、制御する宛先でデータを消費する方法を設定する必要があります。 完全なセットアップには、CXone Mpowerの構成手順と、ストリームをサブスクライブして消費するサービスまたはシステムの設定が含まれます。

CXone Mpowerでストリームを設定する場合、次のスキーマ形式でデータを使用することを選択できます。

  • プロト
  • JSON
  • アブロ
  • 改行を含むJSON
  • JSON AVRO と改行

Kafkaデータストリームをセットアップする

まず、Kafkaストリームの使用方法を計画します。 ストリームをサブスクライブできる宛先を作成するための技術リソースが必要です。 これには、セキュリティ要件に対応する必要があります。

  • Kafkaトピックへのアクセスに使用する IPv4 CIDR を提供する。 これにより、CXone MpowerIPが正当であり、許可されていることが保証されます。 一度に 2 つの IP CIDR を追加できます。

  • CXone Mpowerのユーザー名とパスワードの資格情報を使用する認証方法。

KafkaデータストリームをCXone Mpowerで作成する

次の手順は、データ・ストリームの作成、資格証明のセットの生成、およびデータ・ストリームへのサブスクライブに使用する IP CIDR の追加に役立ちます。

  1. アプリセレクターアプリセレクターのアイコンをクリックして、次を選択します：Admin。
  2. アカウント設定 > [イベントデータストリーム]に移動します。

  3. 新しいデータストリームの作成をクリックします。

  4. データストリームの名前を入力し、オプションで説明を入力します。

  5. IVRログをイベントタイプとして選択します。

  6. データ形式で、データを表示するスキーマ形式を選択します。

  7. ターゲットストリーム Type で、Kafka 外部 を選択します。

  8. 資格情報のセットを生成します。 これは、Kafkaストリームのサブスクライブに使用できるユーザー名とパスワードです。

    1. 新規データストリームページのセキュリティセクションで管理をクリックします。[Security Manager] ウィンドウが開きます。

    2. [エイリアス] に、認証情報のセットの一意の名前を入力します。 英数字は6文字以上入力する必要があります。 使用できる特殊文字は、ダッシュ (-) またはアンダースコア (_) のみです。

      1 つのデータ ストリームに対して一度に作成できる資格情報のセットは 2 つだけです。 必要に応じて、一連の資格情報を削除してから、新しい資格情報を作成できます。

    3. 作成してダウンロードをクリックします。 これにより、ユーザー名とパスワードがCSVファイルとしてダウンロードされます。

  9. 同じセキュリティマネージャウィンドウで、下にスクロールして、データストリームに使用するIP CIDRを入力します。

    1. [許可された IP CIDR] セクションまで下にスクロールします。

    2. IP CIDR には、サブスクライブする IP アドレスの完全な CIDR を入力します。 完全なCIDRアドレスには、IPアドレスとサブネットマスクの両方を必ず含めてください。 一度に複数のCIDRをカンマで区切って入力できます。

      • 1 つのデータ・ストリームに対して、一度に 2 セットの IP CIDR しか持つことができません。 必要に応じて、IP CIDR を削除できます。
      • Data Streams は現在 IPv4 をサポートしています。
      • 最大許容範囲は /24 から /32 の間です。

    3. OKをクリックします。

  10. [作成]をクリックします。

データストリームを作成すると、下部にストリームの詳細が表示されます。 これには、ブローカーの詳細、コンシューマーグループ ID、およびトピック名が含まれます。 これらを使用して、データを使用するサービスまたはシステムをセットアップできます。

また、データストリームは通常、作成後すぐにアクティブになります。 最大で15〜30分かかる場合があります。

Kafkaストリームを購読する宛先を設定する

独自のKafka宛先 に、前のセクションで生成したストリームブローカーの詳細を挿入する必要があります。 そのためには、技術チームが専門知識を活用する必要があります。

Kafka資格情報の削除

セキュリティ上の理由から、資格情報のセットを置き換える必要がある、または置き換える必要がある場合があります。 CXone Mpowerでは、資格情報のセットを論理的に削除または物理的に削除するオプションがあります。 論理的な削除とは、資格情報が 2 日間非アクティブになり、その後完全に削除されることを意味します。 これにより、新しい資格情報のセットを生成し、Kafkaサブスクリプションに実装する時間を確保できます。 物理的な削除は即時削除です。

  1. アプリセレクターアプリセレクターのアイコンをクリックして、次を選択します：Admin。
  2. アカウント設定 > [イベントデータストリーム]に移動します。
  3. 目的のデータストリームを選択します。
  4. 資格情報エイリアスが一覧表示されているセキュリティセクションで、[管理] をクリックします。
  5. 削除する資格情報の [アクション] 列の削除アイコンをクリックします。 確認通知が表示されます。
  6. 資格情報を論理的に削除するか、物理的に削除するかを選択します。
    • 論理的な削除を行うには、削除を確認します。 ステータスアイコンが黄色に変わります。 2 日後、資格情報は完全に削除されます。
    • 物理的に削除するには、資格情報をすぐに削除するチェックボックスを有効にしてから、削除を確認します。

Kafka Data Streamsに関する問題のトラブルシューティング

データ ストリーム サブスクリプションが正しく機能していない場合は、次の点を確認してください。

  • ストリームにサブスクライブしているシステムに正しいブローカーの詳細を入力しました。 これらは、データストリームの詳細のストリームの詳細セクションのCXone Mpowerにあります。

  • 正しいIPv4 CIDRを入力したことを確認するためのデータストリームの詳細。 これらのIPがインターフェイスでもアクティブCXone Mpowerとして表示されていることを確認します。

  • データ ストリームを使用するシステムで資格情報が正しいこと。