Skip to content

Commit 21c8c82

Browse files
lucacomelucacome
authored
Merge branch 'main' into chore/more-linters
2 parents fcbd805 + 66318f2 commit 21c8c82

28 files changed

+574
-67
lines changed

‎examples/client-settings-policy/README.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,3 @@
11
# Client Settings Policy
22

3-
This directory contains YAML files of ClientSettingsPolicies.
3+
This directory contains the YAML files used in the [ClientSettingsPolicy](https://docs.nginx.com/nginx-gateway-fabric/how-to/traffic-management/client-settings/) guide.

‎examples/client-settings-policy/cafe.yaml renamed to ‎examples/client-settings-policy/app.yaml

File renamed without changes.

‎examples/client-settings-policy/csp-grpcroute.yaml

-14
This file was deleted.

‎examples/client-settings-policy/csp-httproutes.yaml

-38
This file was deleted.

‎examples/client-settings-policy/csp-gateway.yaml renamed to ‎examples/client-settings-policy/gateway-client-settings.yaml

+2-10
Original file line numberDiff line numberDiff line change
@@ -1,19 +1,11 @@
11
apiVersion: gateway.nginx.org/v1alpha1
22
kind: ClientSettingsPolicy
33
metadata:
4-
name: gw
5-
namespace: default
4+
name: gateway-client-settings
65
spec:
76
targetRef:
87
group: gateway.networking.k8s.io
98
kind: Gateway
109
name: gateway
1110
body:
12-
maxSize: 10m
13-
timeout: 30s
14-
keepAlive:
15-
requests: 100
16-
time: 5s
17-
timeout:
18-
server: 2s
19-
header: 1s
11+
maxSize: "50" # sizes without a unit are bytes.

‎examples/client-settings-policy/gateway.yaml

-4
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,3 @@ spec:
99
port: 80
1010
protocol: HTTP
1111
hostname: "*.example.com"
12-
- name: http2
13-
port: 8080
14-
protocol: HTTP
15-
hostname: "*.example.org"

‎examples/client-settings-policy/grpc-client-settings.yaml

+11
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,11 @@
1+
apiVersion: gateway.nginx.org/v1alpha1
2+
kind: ClientSettingsPolicy
3+
metadata:
4+
name: grpc-client-settings
5+
spec:
6+
targetRef:
7+
group: gateway.networking.k8s.io
8+
kind: GRPCRoute
9+
name: my-grpc-route
10+
body:
11+
maxSize: "75" # sizes without a unit are bytes.

‎examples/client-settings-policy/cafe-routes.yaml renamed to ‎examples/client-settings-policy/httproutes.yaml

File renamed without changes.

‎examples/client-settings-policy/tea-client-settings.yaml

+11
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,11 @@
1+
apiVersion: gateway.nginx.org/v1alpha1
2+
kind: ClientSettingsPolicy
3+
metadata:
4+
name: tea-client-settings
5+
spec:
6+
targetRef:
7+
group: gateway.networking.k8s.io
8+
kind: HTTPRoute
9+
name: tea
10+
body:
11+
maxSize: "75" # sizes without a unit are bytes.

‎site/content/how-to/monitoring/tracing.md

+4
Original file line numberDiff line numberDiff line change
@@ -13,6 +13,10 @@ NGINX Gateway Fabric supports tracing using [OpenTelemetry](https://opentelemetr
1313

1414
This guide explains how to enable tracing on HTTPRoutes using NGINX Gateway Fabric. It uses the OpenTelemetry Collector and Jaeger to process and collect the traces.
1515

16+
{{< important >}}
17+
Tracing cannot be enabled for [HTTPRoute matches](https://gateway-api.sigs.k8s.io/reference/spec/#gateway.networking.k8s.io/v1.HTTPRouteMatch) with `headers`, `params`, or `method` matchers defined. It will be added in a future release.
18+
{{< /important >}}
19+
1620
## Install the Collectors
1721

1822
The first step is to install the collectors. NGINX Gateway Fabric will be configured to export to the OpenTelemetry Collector, which is configured to export to Jaeger. This model allows the visualization collector (Jaeger) to be swapped with something else, or to add more collectors without needing to reconfigure NGINX Gateway Fabric. It is also possible to configure NGINX Gateway Fabric to export directly to Jaeger.

‎site/content/how-to/monitoring/troubleshooting.md

+28
Original file line numberDiff line numberDiff line change
@@ -109,3 +109,31 @@ If using NGINX Gateway Fabric with NGINX Plus as the data plane, you will see th
109109
#### Resolution
110110

111111
To resolve this issue, enable Usage Reporting by following the [Usage Reporting]({{< relref "installation/usage-reporting.md" >}}) guide.
112+
113+
### 413 Request Entity Too Large
114+
115+
#### Description
116+
117+
If you receive the following error:
118+
119+
```text
120+
<html>
121+
<head><title>413 Request Entity Too Large</title></head>
122+
<body>
123+
<center><h1>413 Request Entity Too Large</h1></center>
124+
<hr><center>nginx/1.25.5</center>
125+
</body>
126+
</html>
127+
```
128+
129+
Or view the following error message in the NGINX logs:
130+
131+
```text
132+
2024/05/30 21:48:22 [error] 138#138: *43 client intended to send too large body: 112 bytes, client: 127.0.0.1, server: cafe.example.com, request: "POST /coffee HTTP/1.1", host: "cafe.example.com:8080"
133+
```
134+
135+
The request body exceeds the [client_max_body_size](https://nginx.org/en/docs/http/ngx_http_core_module.html#client_max_body_size).
136+
137+
#### Resolution
138+
139+
You can configure the `client_max_body_size` using the `ClientSettingsPolicy` API. Read the [Client Settings Policy]({{< relref "how-to/traffic-management/client-settings.md" >}}) documentation for more information.

0 commit comments

Comments
 (0)