vault/website/pages/api-docs/system/host-info.mdx
Jeff Escalante 45b9f7c1a5
🌷 Docs Website Maintenance (#8985)
* website maintenance round
* improve docs, revert bug workaround as it was fixed
* boost memory
* remove unnecessary code
2020-05-21 13:18:17 -04:00

84 lines
1.6 KiB
Plaintext

---
layout: api
page_title: /sys/host-info - HTTP API
sidebar_title: <code>/sys/host-info</code>
description: The '/sys/host-info' endpoint is used to retrieve host information
---
# `/sys/host-info`
The `/sys/host-info` endpoint is used retrieve information about the
host instance that the Vault server is running on.
## Collect Host Information
This endpoint returns information about the host instance that the Vault
server is running on. The data returned includes CPU information, CPU
times, disk usage, host info, and memory statistics.
| Method | Path |
| :----- | :--------------- |
| `GET` | `/sys/host-info` |
### Sample Request
```shell-session
$ curl \
--header "X-Vault-Token: ..." \
http://127.0.0.1:8200/v1/sys/host-info
```
### Sample Response
```json
{
"data": {
"cpu": [
{
"cpu": 0,
"vendorId": "GenuineIntel",
"family": "6",
"model": "78",
...
},
...
],
"cpu_times": [
{
"cpu": "cpu",
"user": 7491,
"system": 16833,
"idle": 5726276,
...
},
...
],
"disk": [
{
"path": "/",
"fstype": "ext4",
"total": 410352476160,
"free": 102141169664,
"used": 306428051456,
...
},
...
],
"host": {
"hostname": "vault-server-1",
"uptime": 28618,
"bootTime": 1570114491,
"procs": 439,
...
},
"memory": {
"total": 17179869184,
"available": 6203424768,
"used": 10976444416,
...
},
"timestamp": "2019-10-03T22:51:49.715927Z"
}
}
```