日志记录参考

使用日志记录 API

日志记录 API

日志记录 API 由 DC/OS 日志组件 支持,后者在群集中的所有节点上运行。有关使用日志记录 API 的更多信息,请参阅 . 关于使用示例,请参阅 日志记录 API 示例.

对于 DC/OS 1.11 及更新版本,日志记录 API 已有重大更新。

在 1.11 之前的 DC/OS 版本中,任务日志可通过 获得。现在,您可以利用组件和任务日志的综合 API。

在 1.11 之前的 DC/OS 版本中,节点和组件日志由 管理。. 不过,由于 [journald 性能问题],[Mesos 任务 journald 日志槽已被禁用]。(/mesosphere/dcos/cn/2.1/installing/production/advanced-configuration/configuration-reference/#mesos-container-log-sink). 因此,只能通过 Mesos 任务沙盒文件 API 来访问旧版本的容器日志文件。

以下代码可能有用:

路由

代理节点的日志记录 API 访问是根据 ,通过管理节点代理到适当代理节点的:{agent_id}:

要确定群集的地址,请参阅 .

服务于任务日志的管理节点路由也被称为*‘发现端点’*。用户对发现端点进行 GET 请求时,用户被重定向到具有所需端点的代理节点。

请求中使用的参数来自 Mesos state.json,被称为“任务元数据”。

认证

所有日志记录 API 路由均需要认证才能使用。要验证 API 请求,请参阅 获取认证令牌 和 .

用户也可以通过 dcos:superuser 权限来到达所有路由。要为您的账户分配权限,请参阅 权限参考.

格式

API 请求标题可以是以下任何一项:

  • 文本格式的 text/plain、、*/* 请求日志,以 \n 结束。
  • - 服务器发送事件格式的 请求日志。

DC/OS 日志记录遵循 . 如果客户端指定了 SSE 规范中所定义的请求标题 Last-Event-ID(最后一个事件的 ID),则它支持从特定光标位置读取日志条目。SSE 格式的每个日志条目都包含带有令牌 ID 的 ID:这可以让客户端知道当前日志条目,让您能够在它被中断时恢复日志消耗。

上述路由 均提供以下资源:

Fluent Bit

标签