community.general.nginx_status_info module – Retrieve information on nginx status

Note

This module is part of the community.general collection (version 9.4.0).

It is not included in ansible-core. To check whether it is installed, run ansible-galaxy collection list.

To install it, use: ansible-galaxy collection install community.general.

To use it in a playbook, specify: community.general.nginx_status_info.

Synopsis

  • Gathers information from nginx from an URL having stub_status enabled.

Parameters

Parameter

Comments

timeout

integer

HTTP connection timeout in seconds.

Default: 10

url

string / required

URL of the nginx status.

Attributes

Attribute

Support

Description

check_mode

Support: full

This action does not modify state.

Can run in check_mode and return changed status prediction without modifying target.

diff_mode

Support: N/A

This action does not modify state.

Will return details on what has changed (or possibly needs changing in check_mode), when in diff mode.

Notes

Note

Examples

# Gather status info from nginx on localhost
- name: Get current http stats
  community.general.nginx_status_info:
    url: http://localhost/nginx_status
  register: result

# Gather status info from nginx on localhost with a custom timeout of 20 seconds
- name: Get current http stats
  community.general.nginx_status_info:
    url: http://localhost/nginx_status
    timeout: 20
  register: result

Return Values

Common return values are documented here, the following are the fields unique to this module:

Key

Description

accepts

integer

The total number of accepted client connections.

Returned: success

Sample: 81769947

active_connections

integer

Active connections.

Returned: success

Sample: 2340

data

string

HTTP response as is.

Returned: success

Sample: "Active connections: 2340 \nserver accepts handled requests\n 81769947 81769947 144332345 \nReading: 0 Writing: 241 Waiting: 2092 \n"

handled

integer

The total number of handled connections. Generally, the parameter value is the same as accepts unless some resource limits have been reached.

Returned: success

Sample: 81769947

reading

integer

The current number of connections where nginx is reading the request header.

Returned: success

Sample: 0

requests

integer

The total number of client requests.

Returned: success

Sample: 144332345

waiting

integer

The current number of idle client connections waiting for a request.

Returned: success

Sample: 2092

writing

integer

The current number of connections where nginx is writing the response back to the client.

Returned: success

Sample: 241

Authors

  • René Moser (@resmo)