消息队列Kafka版可以作为Input接入Logstash。本文说明如何在公网环境下通过Logstash从消息队列Kafka版消费消息。

前提条件

在开始本教程前,请确保您已完成以下操作:

步骤一:获取接入信息

Logstash通过消息队列Kafka版的接入点与消息队列Kafka版建立连接,并通过用户名及密码进行校验。

  1. 登录消息队列Kafka版控制台
  2. 在左侧导航栏,单击实例详情
  3. 实例详情页面,选择要作为Input接入Logstash的实例。
  4. 基本信息区域,获取实例的接入点。
    step4
    说明 不同接入点的差异,请参见接入点对比
  5. 安全配置区域,获取实例的用户名和密码。
    configure

步骤二:创建Topic

创建用于存储消息的Topic。

  1. 消息队列Kafka版控制台的左侧导航栏,单击Topic管理
  2. Topic管理页面,单击创建Topic
  3. 创建Topic页面,输入Topic信息,然后单击创建
    logstash_2

步骤三:发送消息

向创建的Topic发送消息。

  1. 消息队列Kafka版控制台的Topic管理页面,找到创建的Topic,在其右侧操作列,单击发送消息
  2. 发送消息对话框,输入消息信息,然后单击发送
    logstash_4

步骤四:创建Consumer Group

创建Logstash所属的Consumer Group。

  1. 消息队列Kafka版控制台的左侧导航栏,单击Consumer Group管理
  2. Consumer Group管理页面,单击创建Consumer Group
  3. 创建Consumer Group页面,输入Consumer Group信息,然后单击创建
    logstash_3

步骤五:Logstash消费消息

在安装了Logstash的机器上启动Logstash,从创建的Topic中消费消息。

  1. 执行以下命令切换到logstash的bin目录。
    cd /home/logstash/logstash-7.6.2/bin
  2. 执行以下命令下载kafka.client.truststore.jks证书文件。
    wget https://github.com/AliwareMQ/aliware-kafka-demos/blob/master/kafka-log-stash-demo/vpc-ssl/kafka.client.truststore.jks
  3. 创建jaas.conf配置文件。
    1. 执行命令vim jaas.conf
    2. i键。
    3. 输入以下内容。
      KafkaClient {
        org.apache.kafka.common.security.plain.PlainLoginModule required
        username="XXX"
        password="XXX";
      };
      参数 描述 示例值
      username 公网/VPC实例的用户名。 alikafka_pre-cn-v0h1***
      password 公网/VPC实例的密码。 GQiSmqbQVe3b9hdKLDcIlkrBK6***
  4. 创建input.conf配置文件。
    1. 执行命令vim input.conf
    2. i键。
    3. 输入以下内容。
      input {
          kafka {
              bootstrap_servers => "121.XX.XX.XX:9093,120.XX.XX.XX:9093,120.XX.XX.XX:9093"
              topics => ["logstash_test"]
      
              security_protocol => "SASL_SSL"
              sasl_mechanism => "PLAIN"
      
              jaas_path => "/home/logstash-7.6.2/bin/jaas.conf"
      
              ssl_truststore_password => "KafkaOnsClient"
              ssl_truststore_location => "/home/logstash-7.6.2/bin/kafka.client.truststore.jks"
      
              ssl_endpoint_identification_algorithm => ""
      
              group_id => "logstash_group"
              consumer_threads => 3
              auto_offset_reset => "earliest"
          }
      }
      
      output {
          stdout {
              codec => rubydebug
          }
      }
      参数 描述 示例值
      bootstrap_servers 消息队列Kafka版提供的公网接入点为SSL接入点。 121.XX.XX.XX:9093,120.XX.XX.XX:9093,120.XX.XX.XX:9093
      topics Topic的名称。 logstash_test
      security_protocol 安全协议。默认为SASL_SSL,无需修改。 SASL_SSL
      sasl_mechanism 安全认证机制。默认为PLAIN,无需修改。 PLAIN
      jaas_path jaas.conf配置文件位置。 /home/logstash-7.6.2/bin/jaas.conf
      ssl_truststore_password kafka.client.truststore.jks证书密码。默认值为KafkaOnsClient,无需修改。 KafkaOnsClient
      ssl_truststore_location kafka.client.truststore.jks证书位置。 /home/logstash-7.6.2/bin/kafka.client.truststore.jks
      ssl_endpoint_identification_algorithm 6.x及以上版本Logstash需要加上该参数。 空值
      group_id Cosumer Group的名称。 logstash_group
      consumer_threads 消费线程数。建议与Topic的分区数保持一致。 12
      auto_offset_reset 重置偏移量。取值:
      • earliest:读取最早的消息。
      • latest:读取最新的消息。
      earliest
    4. Esc键,输入:wq,然后回车。
  5. 执行以下命令消费消息。
    ./logstash -f input.conf

    返回结果如下。

    result

更多信息

更多参数设置,请参见Kafka input plugin