当对象存储服务OSS（Object Storage Service）文件发生变更，触发阿里云消息服务MNS（Message Notification Service）事件通知时，您可以通过阿里云Logstash的logstash-input-oss插件获取OSS变更事件，再通过logstash-output-oss插件将数据同步到OSS Bucket中。本文介绍对应的配置方法。

前提条件

您已完成以下操作：
  • 安装logstash-input-oss和logstash-output-oss插件。

    详情请参见安装Logstash插件。

  • 开通阿里云OSS服务并准备数据。

    详情请参见开通OSS服务。

  • 开通消息服务MNS，并确保与OSS服务在同一区域。

    详情请参见开通MNS服务。

    说明 本示例设置事件通知类型为PostObject、PutObject，即触发Post、Put事件请求，logstash-output-oss插件同步此数据到对端OSS。

操作步骤

  1. 步骤一：配置事件通知规则
  2. 步骤二：配置Logstash管道
  3. 步骤三：查看数据同步结果

步骤一：配置事件通知规则

  1. 登录OSS管理控制台。
  2. 在左侧导航栏，单击Bucket列表，再单击目标Bucket名称。
  3. 单击基础设置 > 事件通知。
  4. 在事件通知区域，单击设置。
  5. 单击创建规则。
  6. 在创建规则页面，配置事件通知规则。
    本示例配置的事件通知如下。事件通知配置

    配置参数详情请参见配置事件通知。

    说明 资源描述目录中不能包含特殊字符，更多事件类型请参见事件通知。
  7. 单击确定。
  8. 可选： 查看事件通知规则。
    1. 进入消息服务MNS控制台。
    2. 在顶部菜单栏选择地域。
    3. 在左侧导航栏，单击事件通知。

步骤二：配置Logstash管道

  1. 登录阿里云Logstash控制台。
  2. 在顶部菜单栏处，选择地域。
  3. 在实例列表页面，单击实例ID/名称链接，或者单击操作栏下的实例管理。
  4. 单击左侧导航栏的管道管理。
  5. 在管道列表区域，单击创建管道。
    创建管道
  6. 在创建管道任务页面，进行Config配置。
    本文使用的Config配置如下。 
    input {
  oss {
    endpoint => "oss-cn-hangzhou-internal.aliyuncs.com"
    bucket => "zl-ossoutoss"
    access_key_id => "LTAIaX42ddd******"
    access_key_secret => "zuyBRUUndddddds3e6i******"
    mns_settings => {
       endpoint => "18185036364****.mns.cn-hangzhou-internal.aliyuncs.com"
       queue => "zl-test"
    }
    codec => json {
      charset => "UTF-8"
    }
  }
}

output {
  oss {
    endpoint => "http://oss-cn-hangzhou-internal.aliyuncs.com"              
    bucket => "zl-log-output-test"                          
    access_key_id => "LTAIaxxxxx******"                 
    access_key_secret => "zuxxxx8hBpXs3e6i******"         
    prefix => "oss/database"                         
    recover => true                                      
    rotation_strategy => "size_and_time"                  
    time_rotate => 1                                     
    size_rotate => 1000
    temporary_directory => "/ssd/1/ls-cn-0pp1cwec****/logstash/data/22"                            
    encoding => "gzip"                                 
    additional_oss_settings => {
      max_connections_to_oss => 1024                      
      secure_connection_enabled => false                  
    }

  }
}
    注意
  7. 单击下一步，配置管道参数。
    管道参数配置
    表 1. 管道配置参数说明
    参数 说明
    管道ID 必选，自定义输入。
    管道工作线程 并行执行管道的Filter和Output的工作线程数量。当事件出现积压或CPU未饱和时，请考虑增大线程数，更好地使用CPU处理能力。默认值：实例的CPU核数。
    管道批大小 单个工作线程在尝试执行Filter和Output前，可以从Input收集的最大事件数目。较大的管道批大小可能会带来较大的内存开销。您可以设置LS_HEAP_SIZE变量，来增大JVM堆大小，从而有效使用该值。默认值：125。
    管道批延迟 创建管道事件批时，将过小的批分派给管道工作线程之前，要等候每个事件的时长，单位为毫秒。默认值：50ms。
    队列类型 用于事件缓冲的内部排队模型。可选值：
    • memory：默认值。基于内存的传统队列。
    • persisted：基于磁盘的ACKed队列（持久队列）。
    队列最大字节数 请确保该值小于您的磁盘总容量。默认值：1024MB。
    队列检查点写入数 启用持久性队列时，在强制执行检查点之前已写入事件的最大数目。设置为0，表示无限制。默认值：1024。
    警告 配置完成后，需要进行保存和部署才能生效。保存和部署操作会触发实例变更，请在不影响业务的前提下，继续执行以下步骤。
  8. 单击保存或者保存并部署。
    • 保存：将管道信息保存在Logstash里并触发实例变更，但不会触发配置。保存后，系统会返回管道管理页面。可在管道列表区域，单击操作列下的立即部署，触发配置。
    • 保存并部署：保存并且部署后，才会真正触发配置（也会触发实例变更）。

步骤三：查看数据同步结果

  1. 进入OSS管理控制台。
  2. 上传新的文件到MNS监控的目录中（上文配置事件通知规则时定义的资源描述）。
    上传文件的方法请参见上传文件。
  3. 进入目标端OSS Bucket，查看同步成功的数据。
    注意 OSS插件不是以文档或目录形式进行数据同步，而是按照原文档中的数据一条一条进行读写。根据rotate规则，logstash-output-oss插件先将数据存储在本地临时文件中，当达到一定的时间或者大小再进行上传，所以不能保证同一个文档的数据保存到相同的文档下，例如可能会出现多个文档的部分数据同步到一个文档中的情况。