Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Extend troubleshooting doc #2072

Merged
merged 4 commits into from
Jun 4, 2024
Merged
Changes from 1 commit
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
70 changes: 68 additions & 2 deletions site/content/how-to/monitoring/troubleshooting.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,73 @@ docs: "DOCS-1419"

This topic describes possible issues users might encounter when using NGINX Gateway Fabric. When possible, suggested workarounds are provided.

### NGINX fails to reload
### **General Troubleshooting**

When attempting to diagnose a problem or get support, there are a few important data points that can be collected to help with understanding what issues may exist.

#### Resource Status

To get the status of a resource, use `kubectl describe`. For example, to check the status of the `coffee` HTTPRoute:

```shell
kubectl describe httproutes.gateway.networking.k8s.io coffee [-n namespace]
```

```text
...
Status:
Parents:
Conditions:
Last Transition Time: 2024-05-31T16:22:26Z
Message: The route is accepted
Observed Generation: 1
Reason: Accepted
Status: True
Type: Accepted
Last Transition Time: 2024-05-31T16:22:26Z
Message: All references are resolved
Observed Generation: 1
Reason: ResolvedRefs
Status: True
Type: ResolvedRefs
Controller Name: gateway.nginx.org/nginx-gateway-controller
Parent Ref:
Group: gateway.networking.k8s.io
Kind: Gateway
Name: gateway
Namespace: default
Section Name: http
```

If a resource has any errors relating to its configuration or relation to other resources, it is likely that those errors will be contained within the status.

#### Events

Events may be created by NGINX Gateway Fabric or other Kubernetes components that could indicate system or configuration issues. To see events:

```shell
kubectl get events [-n namespace]
```

#### Logs

Logs of the NGINX Gateway Fabric control plane and data plane can contain information that isn't otherwise reported in status or events. These could include errors in processing or passing traffic.

To see logs for the control plane container (replacing the name of the deployment if necessary):

```shell
kubectl -n nginx-gateway logs deployments/nginx-gateway-fabric -c nginx-gateway
```

To see logs for the data plane container (replacing the name of the deployment if necessary):

```shell
kubectl -n nginx-gateway logs deployments/nginx-gateway-fabric -c nginx
```

You can also see the logs of a container that has crashed or been killed, by specifying the `-p` flag with the above commands.

### **NGINX fails to reload**

#### Description

Expand All @@ -24,7 +90,7 @@ To resolve this issue you will need to set `allowPrivilegeEscalation` to `true`.
- If using Helm, you can set the `nginxGateway.securityContext.allowPrivilegeEscalation` value.
- If using the manifests directly, you can update this field under the `nginx-gateway` container's `securityContext`.

### Usage Reporting errors
### **Usage Reporting errors**

#### Description

Expand Down
Loading