You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
DOCS-2549: Update CC L7 logs to use deployment-patch method
Replace outdated service-annotation method (kubectl annotate svc) with
the deployment-patch approach from CE 3.22-2, add comprehensive
limitations, and improve heading structure.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Copy file name to clipboardExpand all lines: calico-cloud/observability/elastic/l7/configure.mdx
+47-24Lines changed: 47 additions & 24 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -40,32 +40,36 @@ L7 logs are visible in the web console, service graph, in the HTTP tab.
40
40
**Not supported**
41
41
- GKE
42
42
43
-
**Limitations**
43
+
### Limitations
44
44
45
-
- L7 log collection is not supported for host-networked client pods.
46
-
- When selecting and deselecting traffic for L7 log collection, active connections may be disrupted.
45
+
* L7 log collection is not compatible with a service mesh such as Istio.
46
+
* L7 log collection is not supported for host-networked client pods.
47
+
* L7 log collection is supported only on Kubernetes 1.29 and later.
47
48
48
-
{/*TODO-XREFS-CC
49
-
Note removed for CC
50
-
*/}
49
+
:::important
51
50
52
-
## How to
51
+
When you enable L7 log collection for a deployment, all of that deployment's pods will restart.
52
+
Selecting and deselecting traffic for L7 log collection may result in disruptions for active connections.
53
53
54
-
-[Configure Felix for log data collection](#configure-felix-for-log-data-collection)
55
-
-[Configure L7 logs](#configure-l7-logs)
56
-
-[View L7 logs in the web console](#view-l7-logs-in-manager-ui)
54
+
:::
55
+
56
+
:::note
57
+
58
+
L7 logs require a minimum of 1 additional GB of log storage per node, per one-day retention period. Adjust your [Log Storage](../../../operations/logstorage/adjust-log-storage-size.mdx) before you start tasks in the next section.
59
+
60
+
:::
57
61
58
-
###Configure Felix for log data collection
62
+
## Configure Felix for log data collection
59
63
60
64
1. Configure L7 log aggregation, retention, and reporting.
61
65
62
66
For help, see [Felix Configuration documentation](../../../reference/component-resources/node/felix/configuration.mdx#calico-enterprise-specific-configuration).
63
67
64
-
###Configure L7 logs
68
+
## Configure L7 logs
65
69
66
70
In this step, you will configure L7 logs, select logs for collection, and test the configuration.
67
71
68
-
**Configure the ApplicationLayer resource for L7 logs**
72
+
### Configure the ApplicationLayer resource for L7 logs
69
73
70
74
1. Create or update the [ApplicationLayer](../../../reference/installation/api.mdx#applicationlayer) resource named, `tigera-secure`.
71
75
@@ -99,25 +103,44 @@ In this step, you will configure L7 logs, select logs for collection, and test t
99
103
kubectl rollout status -n calico-system ds/l7-log-collector --timeout=120s
100
104
```
101
105
102
-
**Select traffic for L7 log collection**
106
+
### Quickstart: enable log collection on an example app
103
107
104
-
1. Annotate the services you wish to collect L7 logs as shown.
2. To disable the L7 log collection, remove the annotation.
114
+
without the `-n <namespace>` flag, it is going to be installed in the `default` namespace. if you wish to install in a different namespace, specify the `-n <namespace>` flag on all other commands in this tutorial from this point on.
115
+
116
+
1. Patch the `frontend` application deployment to start collecting L7 logs for this application
After annotating a service for L7 log collection, only newly-established connections through that service are proxied by Envoy. Connections established before the service is annotated are not proxied or interrupted, and no logs are generated.
122
+
The above command applies the following patch:
123
+
1. ensures pods in your `frontend` deployment pod template spec has the label `applicationlayer.projectcalico.org/sidecar: true`
124
+
1. ensures pods in your `frontend` deployment pod template spec has the following annotations:
Conversely, when a service is deselected, any previous connections established through the annotated service continue to be proxied by Envoy until they are terminated, and logs are generated.
127
+
Deployment pods will then be expected to restart. Monitor its progress with:
128
+
129
+
```bash
130
+
kubectl rollout status deployment frontend
131
+
```
132
+
133
+
[Google Microservices Demo](https://github.com/GoogleCloudPlatform/microservices-demo) includes a load generator. L7 logs should now start displaying log entries that can be viewed via [various UIs](#view-l7-logs-in-the-web-console)
134
+
135
+
Alternatively, it is possible to test your configuration [manually](#test-your-configuration).
136
+
137
+
1. To disable L7 log collection, reverse the above patch with the following command.
0 commit comments