Skip to content

Commit 260b6f5

Browse files
Add log monitoring guidance and examples to "About subscription licenses" (#91)
* Add log monitoring examples and guidance to "About subscription licenses" * added log warnings to include
1 parent c976027 commit 260b6f5

File tree

4 files changed

+51
-0
lines changed

4 files changed

+51
-0
lines changed
Lines changed: 33 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,33 @@
1+
---
2+
docs:
3+
---
4+
5+
Monitor the [NGINX error log](https://nginx.org/en/docs/ngx_core_module.html#error_log), typically located at `/var/log/nginx/error.log`, for subscription-related issues — such as failed usage reports or approaching license expirations — to catch problems early and keep your subscription compliant.
6+
7+
<br>
8+
9+
Examples of subscription-related log entries include:
10+
11+
- **Failure to upload usage reports**:
12+
13+
``` text
14+
[error] 36387#36387: server returned 500 for <fqdn>:<port> during usage report
15+
[error] 36528#36528: <fqdn>:<port> could not be resolved (host not found) during usage report
16+
[error] 36619#36619: connect() failed (111: Connection refused) for <fqdn>:<port> during usage report
17+
[error] 38888#88: server returned 401 for <ip_address>:443 during usage report
18+
```
19+
20+
- **License approaching expiration**:
21+
22+
``` text
23+
[warn] license will expire in 14 days
24+
```
25+
26+
- **License expiration**:
27+
28+
``` text
29+
[alert] license expiry; grace period will end in 89 days
30+
[emerg] license expired
31+
```
32+
33+
{{<important>}}When a license expires, NGINX Plus stops processing traffic.{{</important>}}

content/nim/admin-guide/license/report-usage-connected-deployment.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -80,3 +80,9 @@ If you prefer submitting usage reports to F5 manually, follow these steps:
8080
## What's reported
8181

8282
{{< include "licensing-and-reporting/reported-usage-data.md" >}}
83+
84+
---
85+
86+
## Error log location and monitoring {#log-monitoring}
87+
88+
{{< include "licensing-and-reporting/log-location-and-monitoring.md" >}}

content/nim/disconnected/report-usage-disconnected-deployment.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -185,3 +185,9 @@ To upload the the usage acknowledgement:
185185
## What’s reported {#telemetry}
186186

187187
{{< include "licensing-and-reporting/reported-usage-data.md" >}}
188+
189+
---
190+
191+
## Error log location and monitoring {#log-monitoring}
192+
193+
{{< include "licensing-and-reporting/log-location-and-monitoring.md" >}}

content/solutions/about-subscription-licenses.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -99,6 +99,12 @@ mgmt {
9999

100100
---
101101

102+
## Error log location and monitoring {#log-monitoring}
103+
104+
{{< include "licensing-and-reporting/log-location-and-monitoring.md" >}}
105+
106+
---
107+
102108
## Understand reported usage metrics {#usage-metrics}
103109

104110
{{< include "licensing-and-reporting/reported-usage-data.md" >}}

0 commit comments

Comments
 (0)