调试与故障排除 on Dapr 文档库

运行 Dapr 时的常见问题

Mon, 01 Jan 0001 00:00:00 +0000

本指南涵盖了安装和运行 Dapr 时可能遇到的常见问题。

安装 Dapr CLI 时 Dapr 无法连接到 Docker

在安装和初始化 Dapr CLI 时，如果在运行 dapr init 后看到以下错误信息：

⌛ 正在进行初始化...
❌ 无法连接到 Docker。Docker 可能未安装或未运行

请通过以下步骤进行排查：

确保容器正确运行。
在 Docker Desktop 中，确认已选择 允许使用默认 Docker 套接字（需要密码） 选项。

我没有看到 Dapr sidecar 注入到我的 pod 中

sidecar 未注入到 pod 中可能有多种原因。首先，检查您的部署或 pod YAML 文件，确保在正确的位置有以下注释：

annotations:
 dapr.io/enabled: "true"
 dapr.io/app-id: "nodeapp"
 dapr.io/app-port: "3000"

示例部署：

apiVersion: apps/v1
kind: Deployment
metadata:
 name: nodeapp
 namespace: default
 labels:
 app: node
spec:
 replicas: 1
 selector:
 matchLabels:
 app: node
 template:
 metadata:
 labels:
 app: node
 annotations:
 dapr.io/enabled: "true"
 dapr.io/app-id: "nodeapp"
 dapr.io/app-port: "3000"
 spec:
 containers:
 - name: node
 image: dapriosamples/hello-k8s-node
 ports:
 - containerPort: 3000
 imagePullPolicy: Always

在某些情况下，这可能无法正常工作：

配置和查看 Dapr 日志

Mon, 01 Jan 0001 00:00:00 +0000

本节将帮助您了解 Dapr 中日志的工作原理，以及如何配置和查看日志。

概述

日志有不同的可配置级别。以下列出的级别适用于系统组件和 Dapr sidecar 进程/容器：

error
warn
info
debug

error 级别输出最少，而 debug 级别输出最多。默认级别是 info，它在正常情况下为操作 Dapr 提供了足够的信息。

要设置输出级别，可以使用 --log-level 命令行选项。例如：

./daprd --log-level error
./placement --log-level debug

这将以 error 日志级别启动 Dapr 运行时二进制文件，并以 debug 日志级别启动 Dapr actor 放置服务。

独立模式下的日志

在使用 Dapr CLI 运行应用程序时，可以通过传递 log-level 参数来设置日志级别：

dapr run --log-level warn node myapp.js

如上所述，每个 Dapr 二进制文件都接受一个 --log-level 参数。例如，要以警告级别启动放置服务：

./placement --log-level warn

查看独立模式下的日志

当使用 Dapr CLI 运行 Dapr 时，您的应用程序日志输出和运行时输出将被重定向到同一会话，方便调试。例如，这是运行 Dapr 时的输出：

Dapr API 日志

Mon, 01 Jan 0001 00:00:00 +0000

API 日志记录可以让您查看应用程序对 Dapr sidecar 的 API 调用情况。这对于监控应用程序行为或进行调试非常有用。您还可以将 Dapr API 日志记录与 Dapr 日志事件结合使用（参见配置和查看 Dapr 日志），以便更好地利用日志记录功能。

概述

API 日志记录默认情况下是禁用的。

要启用 API 日志记录，可以在启动 daprd 进程时使用 --enable-api-logging 命令行选项。例如：

./daprd --enable-api-logging

在自托管模式下配置 API 日志记录

当使用 Dapr CLI 运行应用程序时，要启用 API 日志记录，请传递 --enable-api-logging 标志：

dapr run \
 --enable-api-logging \
 -- node myapp.js

在自托管模式下查看 API 日志

使用 Dapr CLI 运行 Dapr 时，您的应用程序日志输出和 Dapr 运行时日志输出会被重定向到同一会话中，便于调试。

下面的示例显示了一些 API 日志：

$ dapr run --enable-api-logging -- node myapp.js

ℹ️ Starting Dapr with id order-processor on port 56730
✅ You are up and running! Both Dapr and your app logs will appear here.
.....
INFO[0000] HTTP API Called app_id=order-processor instance=mypc method="POST /v1.0/state/mystate" scope=dapr.runtime.http-info type=log useragent=Go-http-client/1.1 ver=edge
== APP == INFO:root:Saving Order: {'orderId': '483'}
INFO[0000] HTTP API Called app_id=order-processor instance=mypc method="GET /v1.0/state/mystate/key123" scope=dapr.runtime.http-info type=log useragent=Go-http-client/1.1 ver=edge
== APP == INFO:root:Getting Order: {'orderId': '483'}
INFO[0000] HTTP API Called app_id=order-processor instance=mypc method="DELETE /v1.0/state/mystate" scope=dapr.runtime.http-info type=log useragent=Go-http-client/1.1 ver=edge
== APP == INFO:root:Deleted Order: {'orderId': '483'}
INFO[0000] HTTP API Called app_id=order-processor instance=mypc method="PUT /v1.0/metadata/cliPID" scope=dapr.runtime.http-info type=log useragent=Go-http-client/1.1 ver=edge

在 Kubernetes 中配置 API 日志记录

您可以通过在 pod 规范模板中添加以下注释来为 sidecar 启用 API 日志：

性能分析与调试

Mon, 01 Jan 0001 00:00:00 +0000

在实际应用中，程序可能会出现资源使用高峰的问题。CPU和内存的使用高峰在很多情况下是常见的。

Dapr 允许用户通过其性能分析服务端点使用 pprof 启动按需性能分析会话，以检测并发、性能、CPU 和内存使用等问题。

启用性能分析

Dapr 支持在 Kubernetes 和独立模式下启用性能分析。

独立模式

在独立模式下启用性能分析时，可以通过 Dapr CLI 传递 --enable-profiling 和 --profile-port 标志：注意，profile-port 是可选的，如果未指定，Dapr 会自动选择一个可用端口。

dapr run --enable-profiling --profile-port 7777 python myapp.py

Kubernetes

在 Kubernetes 中启用性能分析，只需在 Dapr 注解的 pod 中添加 dapr.io/enable-profiling 注解：

 annotations:
 dapr.io/enabled: "true"
 dapr.io/app-id: "rust-app"
 dapr.io/enable-profiling: "true"

调试性能分析会话

启用性能分析后，可以启动性能分析会话来调查 Dapr 运行时的情况。

独立模式

对于独立模式，首先找到需要分析的 Dapr 实例：

dapr list
APP ID DAPR PORT APP PORT COMMAND AGE CREATED PID
node-subscriber 3500 3000 node app.js 12s 2019-09-09 15:11.24 896

获取 DAPR PORT，如果已按上述步骤启用性能分析，现在可以使用 pprof 对 Dapr 进行分析。查看上面的 Kubernetes 示例以获取一些有用的命令来分析 Dapr。