如何在 GKE 上通过 stackdriver 查看容器日志

Question

我读过默认情况下，GKE 上的集群将所有日志写入堆栈驱动程序。 在 GKE UI 上，我可以看到我所有部署的容器日志，但我希望以编程方式从 API 获取这些日志。

我尝试执行gcloud logging read "resource.labels.pod_id="<pod-id>""操作，但没有返回任何内容。

我是否需要做一些特别的事情才能在集群上启用日志记录？ 如果没有，我如何访问特定部署/pod/容器的日志？

此外，这些日志是持久的吗？ 例如，当部署终止时，我仍然可以访问这些日志吗？

Answer 1

您可以通过多种方式从 Stackdriver 读取GKE pod 日志。 他们之中有一些是：

阅读日志

要读取 Logging 中的日志条目，您可以执行以下任何操作：

• 使用 Google Cloud Console 中的日志查看器。
• 通过您的编程语言的客户端库调用 Logging API。
• 直接调用 Logging API REST 端点。 请参阅日志记录 API 参考文档。

• 使用云 SDK。 有关更多信息，请参阅 gcloud logging 命令行界面。

  Cloud.google.com：记录：设置

至于：

我是否需要做一些特别的事情才能在集群上启用日志记录？ 如果没有，我如何访问特定部署/pod/容器的日志？

请参考： Cloud.google.com：日志：访问控制

下面回答：

此外，这些日志是持久的吗？ 例如，当部署终止时，我仍然可以访问这些日志吗？

是的，即使部署已删除，您仍然可以访问此日志。 即使您删除了集群，您仍然可以访问日志。 存储在 Stackdriver 中的日志具有保留政策，可将日志存储一段时间。 请参阅：

• Cloud.google.com：日志记录：配额
• Cloud.google.com：记录：存储

---

请看下面的示例，该示例显示了如何使用gcloud命令访问日志：

脚步：

• 创建一个将日志发送到 Stackdriver 的Deployment
• 检查日志是否存储在 Stackdriver
• 使用gcloud从 Stackdriver 获取日志

创建部署

请按照 Google Cloud Platform 指南生成一个将数据发送到 Stackdriver 的Deployment ：

• Cloud.google.com：Kubernetes 引擎：自定义指标自动缩放：开始之前- 开始
• Cloud.google.com：Kubernetes 引擎：自定义指标自动缩放：导出- 结束

检查日志是否在 Stackdriver 中。

通过上述部署导出的日志将存储在 Stackdriver 中。 它的示例应如下所示：

{
 insertId: "REDACTED"  
 labels: {
  k8s-pod/pod-template-hash: "545464fb5"   
  k8s-pod/run: "custom-metric-sd"   
 }
 logName: "projects/REDACTED/logs/stderr"  
 receiveTimestamp: "2020-05-26T10:17:16.161949129Z"  
 resource: {
  labels: {
   cluster_name: "gke-logs"    
   container_name: "sd-dummy-exporter"    
   location: "ZONE"    
   namespace_name: "default"    
   pod_name: "custom-metric-sd-545464fb5-2rdvx"    
   project_id: "REDACTED"    
  }
  type: "k8s_container"   
 }
 severity: "ERROR"  
 textPayload: "2020/05/26 10:17:10 Finished writing time series with value: 0xc420015290
"  
 timestamp: "2020-05-26T10:17:10.356684667Z"  
}

上述日志条目将有助于创建gcloud命令以仅从 Stackdriver 获取指定的日志。

使用gcloud从 Stackdriver 获取日志

正如你所指出的：

我尝试过执行 gcloud logging read "resource.labels.pod_id=""" 之类的操作，但没有返回任何内容。

没有返回任何内容的事实很可能与您使用的命令未找到请求的资源这一事实有关。

要从 Stackdriver 调用以下命令获取此日志：

$ gcloud logging read "resource.type=k8s_container AND resource.labels.container_name=sd-dummy-exporter" 

将上述命令划分为较小的部分：

• resource.type=k8s_container - 它将获取类型为k8s_container的日志
• resource.labels.container_name=XYZ - 它将获取具有指定container_name的日志。

这些片段与前面提到的示例单数日志条目直接相关。

小费：

resources.labels.container_name可用于从多个 pod 收集日志，因为可以使用pod_name引用特定的 pod。