diff --git a/Documentation/upgrades/upgrade_3_5.md b/Documentation/upgrades/upgrade_3_5.md
index 9558cc69a..8fa23d953 100644
--- a/Documentation/upgrades/upgrade_3_5.md
+++ b/Documentation/upgrades/upgrade_3_5.md
@@ -34,6 +34,17 @@ v3.4 renamed [`etcd --log-output` to `--log-outputs`](https://github.com/coreos/
 +etcd --log-outputs stderr,a.log
 ```
 
+#### Deprecated in `etcd --log-package-levels`
+
+**`etcd --log-package-levels` for `capnslog` has been deprecated**.
+
+Now, **`etcd --logger=zap`** is the default.
+
+```diff
+-etcd --log-package-levels 'etcdmain=CRITICAL,etcdserver=DEBUG'
++etcd --logger=zap
+```
+
 #### Changed gRPC gateway HTTP endpoints (deprecated `/v3beta`)
 
 Before