Skip to content

Commit

Permalink
Merge pull request #689 from nginx/map-variables-flags
Browse files Browse the repository at this point in the history
This commit changes the list of NGINX Agent variables to a table showing 
how it maps to the CLI flags, with an exception for the variable that 
doesn't have a flag yet.  It links to the CLI flag section so that the reader
can view the descriptions for additional context.
  • Loading branch information
ADubhlaoich authored May 27, 2024
2 parents 84082a5 + e870bc1 commit 27a2a49
Show file tree
Hide file tree
Showing 2 changed files with 37 additions and 37 deletions.
72 changes: 36 additions & 36 deletions site/content/configuration/configuration-overview.md
Original file line number Diff line number Diff line change
Expand Up @@ -215,42 +215,42 @@ Default location in FreeBSD environments: `/var/db/nginx-agent/agent-dynamic.con

### NGINX Agent Environment Variables

This section displays the configurable options for NGINX Agent that can be set with environment variables. A list of the configurable environment variables can be seen below:

<details open>
<summary>NGINX Agent Environment Variables</summary>

```text
- NMS_INSTANCE_GROUP
- NMS_DISPLAY_NAME
- NMS_FEATURES
- NMS_LOG_LEVEL
- NMS_LOG_PATH
- NMS_PATH
- NMS_METRICS_COLLECTION_INTERVAL
- NMS_METRICS_MODE
- NMS_METRICS_BULK_SIZE
- NMS_METRICS_REPORT_INTERVAL
- NMS_NGINX_EXCLUDE_LOGS
- NMS_NGINX_SOCKET
- NMS_NGINX_TREAT_WARNINGS_AS_ERRORS
- NMS_SERVER_GRPCPORT
- NMS_SERVER_HOST
- NMS_SERVER_TOKEN
- NMS_SERVER_COMMAND
- NMS_SERVER_METRICS
- NMS_TAGS
- NMS_TLS_CA
- NMS_TLS_CERT
- NMS_TLS_ENABLE
- NMS_TLS_KEY
- NMS_TLS_SKIP_VERIFY
- NMS_CONFIG_DIRS
- NMS_QUEUE_SIZE
- NMS_DATAPLANE_REPORT_INTERVAL
- NMS_DATAPLANE_STATUS_POLL_INTERVAL
```
</details>
This section displays the configurable options for NGINX Agent that can be set with environment variables. Each environment variable maps to a CLI flag, [explained above](#nginx-agent-cli-flags-usage).

{{<bootstrap-table "table table-striped table-bordered">}}

| Environment variable | CLI flag |
| ------------------------------------ | ---------------------------------------- |
| *NMS_CONFIG_DIRS* | *--config-dirs* |
| *NMS_DATAPLANE_REPORT_INTERVAL* | *--dataplane-report-interval* |
| *NMS_DATAPLANE_STATUS_POLL_INTERVAL* | *--dataplane-status-poll-interval* |
| *NMS_DISPLAY_NAME* | *--display-name* |
| *NMS_FEATURES* | *--features* |
| *NMS_INSTANCE_GROUP* | *--instance-group* |
| *NMS_LOG_LEVEL* | *--log-level* |
| *NMS_LOG_PATH* | *--log-path* |
| *NMS_PATH* | N/A, defines path for `nginx-agent.conf` |
| *NMS_METRICS_COLLECTION_INTERVAL* | *--metrics-collection-interval* |
| *NMS_METRICS_MODE* | *--metrics-mode* |
| *NMS_METRICS_BULK_SIZE* | *--metrics-bulk-size* |
| *NMS_METRICS_REPORT_INTERVAL* | *--metrics-report-interval* |
| *NMS_NGINX_EXCLUDE_LOGS* | *--nginx-exclude-log* |
| *NMS_NGINX_SOCKET* | *--nginx-socket* |
| *NMS_NGINX_TREAT_WARNINGS_AS_ERRORS* | *--nginx-treat-warnings-as-errors* |
| *NMS_QUEUE_SIZE* | *--queue-size* |
| *NMS_SERVER_GRPCPORT* | *--server-grpcport* |
| *NMS_SERVER_HOST* | *--server-host* |
| *NMS_SERVER_TOKEN* | *--server-token* |
| *NMS_SERVER_COMMAND* | *--server-command* |
| *NMS_SERVER_METRICS* | *--server-metrics* |
| *NMS_TAGS* | *--tags* |
| *NMS_TLS_CA* | *--tls-ca* |
| *NMS_TLS_CERT* | *--tls-cert* |
| *NMS_TLS_ENABLE* | *--tls-enable* |
| *NMS_TLS_KEY* | *--tls-key* |
| *NMS_TLS_SKIP_VERIFY* | *--tls-skip-verify* |

{{</bootstrap-table>}}

### NGINX Agent Log Rotation

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -170,7 +170,7 @@ docker run --name nginx-agent -d nginx-agent
To connect your NGINX Agent container to your NGINX One or NGINX Instance Manager instance, you must enable the gRPC interface. To do this, you must edit the NGINX Agent configuration file, *nginx-agent.conf*. For example:

```yaml
erver:
server:
host: 127.0.0.1 # mock control plane host
grpcPort: 54789 # mock control plane gRPC port
Expand Down

0 comments on commit 27a2a49

Please sign in to comment.