AliyunSls

阿里云SLS服务Ruby SDK

简单日志服务（Simple Log Service，简称SLS）

是针对日志收集、存储和查询的平台化服务。服务提供各种类型日志的实时收集，平台化存储及实时查询海量的日志。并可以将日志归档至ODPS，以利用ODPS做大数据分析。除了通过管理控制台操作，SLS还提供了API（Application Programming Interface）方式写入、查询日志数据，管理自己的项目及日志库等。

SLS(简单日志服务)介绍

库用法

查询Store清单

con = AliyunSls::Connection.new("project", "region", "access_key_secret", "aliyun_access_key")
con.list_logstores

上传日志

log = AliyunSls::Protobuf::Log.new(:time => Time.now.to_i, :contents => [])

[
    ['value1', '12'],
    ['value2', '24'],
    ['value3', '36'],
    ['value4', '48']
].each { |e|  
    k = e[0]
    v = e[1]
    log_item = AliyunSls::Protobuf::Log::Content.new(:key => k, :value => v)
    log.contents << log_item
}
log_list = AliyunSls::Protobuf::LogGroup.new(:logs => [])
log_list.logs << log

con = AliyunSls::Connection.new("project", "region", "access_key_secret", "aliyun_access_key")
con.puts_logs("store", log_list)

列出日志主题

con.list_topics("store")
名称 类型 必选 描述
logstorename 字符串 是 需要查询的Logstore名称。
type 字符串 是 查询Logstore数据的类型，在ListTopics接口中该参数必须为"topic"。
line 整型 否 请求一次返回的Topic最大数目。取值范围为0~100，默认值为100。
token 字符串 否 请求返回Topic的起始点（按字典序）。默认值为空字符串，表示从头开始查询

查询Logstore中的日志在时间轴上的分布

con.get_histograms("store")
名称 类型 必选 描述
logstorename 字符串 是 需要查询日志的Logstore名称。
type 字符串 是 查询Logstore数据的类型，在GetHistograms接口中该参数必须为"histogram"。
from 整型 是 查询开始时间点（精度为秒，从1970-1-1 00:00:00 UTC计算起的秒数）。
to 整型 是 查询结束时间点（精度为秒，从1970-1-1 00:00:00 UTC计算起的秒数）。
topic 字符串 否 查询日志主题。
query 字符串 否 查询表达式。关于查询表达式的详细语法请参考查询语法。

查询Logstore中的日志数据

con.get_logs("store", :topic => "xxx")
名称 类型 必选 描述
logstorename 字符串 是 需要查询日志的Logstore名称。
type 字符串 是 查询Logstore数据的类型，在GetLogs接口中该参数必须为"log"。
from 整型 是 查询开始时间点（精度为秒，从1970-1-1 00:00:00 UTC计算起的秒数）。
to 整型 是 查询结束时间点（精度为秒，从1970-1-1 00:00:00 UTC计算起的秒数）。
topic 字符串 否 查询日志主题。
query 字符串 否 查询表达式。关于查询表达式的详细语法请参考查询语法。
line 整型 否 请求返回的最大日志条数。取值范围0~100，默认值为100。
offset 整型 否 请求返回日志的起始点。取值范围0或正整数，默认值0。
reverse 布尔型 否 是否按日志时间戳逆序返回日志。true表示逆序，false表示顺序，默认值为false。

命令行用法

  1. 生成配置文件
    1. PROJECT=[PROJECT] REGION=[REGION] SECRET=[SECRET] KEY=[KEY] sls setup
  2. 执行上传日志操作
    1. [PROJECT=[PROJECT]] sls put log_path store [topic]
    2. 上传日志操作是使用Tail方式执行，有增量日志产生的时候，会自动收集增量部分上传到阿里云

fluentd-plugin-sls

可以结合fluentd，将日志解析好之后上传到阿里云上，实现日志的统一存储。

gist地址：https://gist.github.com/charlescui/d2a231dbc85b11586fa0

Installation

Add this line to your application's Gemfile:

gem 'aliyun_sls'

And then execute:

$ bundle

Or install it yourself as:

$ gem install aliyun_sls

Usage

TODO: Write usage instructions here

Contributing

  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request