最后更新于2017年11月6日星期一21:12:17 GMT

Get-your-work-done-even-faster-with-the-Logentries-REST-API

现在,通过使用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数据与内部或第三方应用程序集成.