为控制台日志添加偏移量¶

https://blueprints.launchpad.net/nova/+spec/console-log-offset

为了能够从指定位置观察控制台日志，我们需要在控制台日志命令中添加一个新的可选参数，允许从指定位置列出日志。

问题描述¶

当用户触发 console-log 命令时，它会获取从末尾开始的所有日志。当您观察系统活动并希望查看过去发生的事件的日志时，获取所有日志内容可能没有用处。滚动数千行可能令人烦恼。

用例¶

操作员希望从指定的偏移量处观察日志。

提议的变更¶

应该添加额外的可选参数偏移量，以处理操作员想要显示部分日志的情况。

备选方案¶

另一种方法是显示所有日志或从尾部指定数量的行，然后向上滚动直到找到您需要的内容。

数据模型影响¶

无

REST API 影响¶

该提案将为请求添加新的可选参数‘offset’。此更改需要 API 微版本更新。如果日志为空或日志不包含此偏移量，则响应应为空。

请求

URL: /v2.1/{tenant_id}/servers/{server_id}/action

方法

POST

JSON 格式

{
    "os-getConsoleOutput": {
        "lines": 2,
        "offset": 10
    }
}

响应

{
    "output": "ANOTHER\nLAST LINE"
}

安全影响¶

无

通知影响¶

无

其他最终用户影响¶

python nova client 将使用新的可选参数更新 console-logs 命令。新的命令将如下所示

nova console-logs <instanced-id> –length 10 –offset 100

性能影响¶

减少传输到 python-novaclient 的数据量。

其他部署者影响¶

无

开发人员影响¶

无

实现¶

负责人¶

主要负责人: gstepanov

工作项¶

更新获取带有偏移量参数的控制台日志的 API 微版本
通过添加偏移量参数更新 python-novaclient API

依赖项¶

无

测试¶

需要新的 Tempest、功能和单元测试。

文档影响¶

需要新的 API 微版本和用量文档。

参考资料¶

无

为控制台日志添加偏移量