最后更新于2017年11月6日星期一21:12:17 GMT
现在,通过使用Logentries REST API自动化任务,您可以更快地完成工作. 具有以编程方式查询数据的能力, 管理用户, 创建警报和集成第三方工具, 现在更容易完成工作,继续你的一天.
目录表
按需网络研讨会
有兴趣了解更多关于Logentries REST API的信息? 查看我们的前情提要 记录网络研讨会 探讨了Logentries api如何帮助解决常见的挑战.
网络研讨会的细节
记录2016年9月7日,周三,美国东部时间上午11:00
点击这里 查看网络研讨会!
查询API
REST查询API为您的用户和系统提供了一种强大的方式,可以以编程方式查询日志数据,而无需访问Logentries用户界面.
通常在Logentries查询栏中输入的任何LEQL查询都可以提交给API. 您的请求将返回计算结果或日志事件列表作为JSON对象.
使用Logentries REST查询API,你可以:
- 以编程方式查询和分析数据
- 快速检索表示LEQL函数结果或搜索查询结果的JSON对象
- 轻松地将Logentries数据与内部或第三方应用程序集成
示例使用
下面是一个使用查询API GET请求的示例python脚本.
我填写了Apache服务器访问日志的日志键(组合格式), 添加了一个API密钥, 指定的开始和结束时间, 并设置 leqlQuery
to “(http.状态= 200)'
.
我返回的结果是:
{“日志”:[' * logkeyremoved * '], 'leql': {'during': {'to': 1471979100000, “从”:1469466000000}, “声明”:“(http.状态= 200)”},“事件”
[
{'timestamp': 1469754542499, 'message': '45 ..79.152.221 - - [29/Jul/2016:01:09:11 +0000] "GET / HTTP/1.0" 200 11892 "-" "-"'},
{'timestamp': 1469789339630, 'message': '94.102.49.26——- [29/Jul/2016:10:49:08 +0000] "GET / HTTP/1.1“20011892”-“”Mozilla/5.0 (Windows NT 6).1; WOW64) AppleWebKit/537.36 (KHTML,像壁虎)Chrome/46.0.2490.80 Safari / 537.36"'},
{'timestamp': 1469916895582, 'message': '169 ..54.244.82 - - [30/Jul/2016:22:15:04 +0000] "GET / HTTP/1.1" 200 11873 "-" "-"'},
{'timestamp': 1469958008458, 'message': '208.73.20.[31/Jul/2016:09:40:17 +0000] "GET / HTTP/1.1“20011873”-“”Mozilla/4.0 (compatible; MSIE 8.0; Windows NT 6.1; Trident/4.0; SLCC2; .净CLR 2.0.50727; .净CLR 3.5.30729; .净CLR 3.0.30729; Media Center PC 6.0)"'},
...
]}
您可以轻松地将Logentries 查询API与常见的第三方工具(如Hosted Graphite)集成在一起, Geckoboard, Kafka和其他服务通过使用开源工具LeExportPy. 看到 LeExportPy部分 欲知详情.
有关其他示例用例,请查看我们的博客文章 使用JavaScript与REST查询API交互.
团队和用户管理API
Logentries团队和用户管理API允许您轻松添加, 删除和修改帐户用户, 创建团队, 限制访问.
示例使用
下面的python脚本使用Logentries团队和用户管理API来检索指定帐户中所有团队的列表:
这将以JSON对象的形式返回指定帐户的所有球队列表. 见下文:
{
“团队”:(
{
“用户”:(
{
"id": "********-****-****-****-************",
“链接”:{
“href”:“http://rest.logentries.com/management/accounts /********-****-****-****-************/ 用户/ d ********-****-****-****-************",
“ref”:“自我”
}
}
],
"id": "********-****-****-****-************",
"name": "Read Only Team"
}
]
}
标签和警报API
标记和警报API可以轻松地快速创建标记和设置警报,以提醒您注意重要事件.
示例使用
在下面的python脚本中,GET请求调用Logentries 标签和警报API来获取与指定API密钥关联的帐户中所有标签/警报的列表.
只需从您的帐户中输入(至少)只读API密钥. 返回的信息示例如下:
{
“标签”:[
{
name:用户变更,
“模式”:[
“会话关闭”
],
“标签”:[
{
“颜色”:“f061fb”,
“保留”:假的,
"id": "********-****-****-****-************",
name:用户已更改;
"sn": 1050
}
],
“行动”(
{
“min_matches_period”:“天”,
“min_report_period”:“天”,
“min_matches_count”:1、
“启用”:假的,
“min_report_count”:1、
“目标”:“
{
“alert_content_set”:{},
" params_set ": {
“用户”:“demo.com”,
“直接”:“demo.com”,
“团队”:“
},
“类型”:“Mailto”,
“id”:null
}
],
“类型”:“警戒”,
"id": "********-****-****-****-************"
}
],
“来源”:[
{
“retention_period”:“默认”,
“stored_days”:[],
"id": "********-****-****-****-************",
“名称”:“消息”
},
],
“类型”:“警戒”,
"id": "********-****-****-****-************"
},
{
name:鉴权失败,
“模式”:[
“验证失败”
],
“标签”:[
{
“颜色”:“fb0000”,
“保留”:假的,
"id": "********-****-****-****-************",
“name”:“Auth Failure”,
"sn": 1046
}
],
“行动”(
{
“min_matches_period”:“天”,
“min_report_period”:“天”,
“min_matches_count”:5
“启用”:假的,
“min_report_count”:5
“目标”:“
{
“alert_content_set”:{},
" params_set ": {
“用户”:“demo.com”,
“直接”:“demo.com”,
“团队”:“
},
“类型”:“Mailto”,
“id”:null
}
],
“类型”:“警戒”,
"id": "********-****-****-****-************"
}
],
“来源”:[
{
“retention_period”:“默认”,
“stored_days”:[],
"id": "********-****-****-****-************",
“名称”:“消息”
},
], ,
“类型”:“警戒”,
"id": "********-****-****-****-************"
}
]
}
LeExportPy
开源工具LeExportPy提供了一个功能齐全的框架,用于从Logentries 查询API捕获日志数据并将该数据导出到其他服务. 目前,集成可用于托管石墨、Geckoboard和Kafka. Adding new integration is easy; the documentation to create a new service can be found on GitHub.
LeCLI
开源的Logentries CLI允许您无缝地查看最近的事件, 从命令行运行查询并管理您的帐户. CLI利用本文中提到的Logentries REST api调用, 文档中的调用, 并在添加API功能时利用未来的调用.
Logentries CLI的好处
- 跨平台,支持所有主流操作系统.
- 快速检索日志数据并操作Logentries帐户,而无需使用图形用户界面.
- 轻松构建脚本以利用Logentries REST api.
- 轻松地将Logentries数据与内部或第三方应用程序集成.