From 939f4832eef394690c9298b253591f4e0b992489 Mon Sep 17 00:00:00 2001 From: Calle Pettersson Date: Sun, 18 Nov 2018 18:24:58 +0100 Subject: [PATCH] Add docs --- README.md | 1 + docs/collector.memory.md | 59 ++++++++++++++++++++++++++++++++++++++++ 2 files changed, 60 insertions(+) create mode 100644 docs/collector.memory.md diff --git a/README.md b/README.md index e3669a7c..8566f514 100644 --- a/README.md +++ b/README.md @@ -17,6 +17,7 @@ Name | Description | Enabled by default [iis](docs/collector.iis.md) | [Win32_PerfRawData_W3SVC_WebService](https://msdn.microsoft.com/en-us/library/aa394345) IIS metrics | [logical_disk](docs/collector.logical_disk.md) | [Win32_PerfRawData_PerfDisk_LogicalDisk](https://msdn.microsoft.com/en-us/windows/hardware/aa394307(v=vs.71)) metrics (disk I/O) | ✓ [net](docs/collector.net.md) | [Win32_PerfRawData_Tcpip_NetworkInterface](https://technet.microsoft.com/en-us/security/aa394340(v=vs.80)) metrics (network interface I/O) | ✓ +[memory](docs/collector.memory.md) | Memory usage metrics | [msmq](docs/collector.msmq.md) | [Win32_PerfRawData_MSMQ_MSMQQueue](http://wutils.com/wmi/root/cimv2/win32_perfrawdata_msmq_msmqqueue/) metrics (MSMQ/journal count) | [mssql](docs/collector.mssql.md) | various [SQL Server Performance Objects](https://docs.microsoft.com/en-us/sql/relational-databases/performance-monitor/use-sql-server-objects#SQLServerPOs) metrics | [os](docs/collector.os.md) | [Win32_OperatingSystem](https://msdn.microsoft.com/en-us/library/aa394239) metrics (memory, processes, users) | ✓ diff --git a/docs/collector.memory.md b/docs/collector.memory.md new file mode 100644 index 00000000..2b5247c4 --- /dev/null +++ b/docs/collector.memory.md @@ -0,0 +1,59 @@ +# memory collector + +The memory collector exposes metrics about system memory usage + +Metric name prefix | `memory` +Classes | `Win32_PerfRawData_PerfOS_Memory` +Enabled by default? | Yes + +## Flags + +None + +## Metrics + +Name | Description | Type | Labels +-----|-------------|------|------- +`wmi_cs_logical_processors` | Number of installed logical processors | gauge | None +`wmi_cs_physical_memory_bytes` | Total installed physical memory | gauge | None +`wmi_memory_available_bytes` | The amount of physical memory immediately available for allocation to a process or for system use. It is equal to the sum of memory assigned to the standby (cached), free and zero page lists | gauge | None +`wmi_memory_cache_bytes` | _Not yet documented_ | gauge | None +`wmi_memory_cache_bytes_peak` | _Not yet documented_ | gauge | None +`wmi_memory_cache_faults_total` | _Not yet documented_ | gauge | None +`wmi_memory_commit_limit` | _Not yet documented_ | gauge | None +`wmi_memory_committed_bytes` | _Not yet documented_ | gauge | None +`wmi_memory_demand_zero_faults_total` | The number of zeroed pages required to satisfy faults. Zeroed pages, pages emptied of previously stored data and filled with zeros, are a security feature of Windows that prevent processes from seeing data stored by earlier processes that used the memory space | gauge | None +`wmi_memory_free_and_zero_page_list_bytes` | _Not yet documented_ | gauge | None +`wmi_memory_free_system_page_table_entries` | _Not yet documented_ | gauge | None +`wmi_memory_modified_page_list_bytes` | _Not yet documented_ | gauge | None +`wmi_memory_page_faults_total` | _Not yet documented_ | gauge | None +`wmi_memory_swap_page_reads_total` | Number of disk page reads (a single read operation reading several pages is still only counted once) | gauge | None +`wmi_memory_swap_pages_read_total` | Number of pages read across all page reads (ie counting all pages read even if they are read in a single operation) | gauge | None +`wmi_memory_swap_pages_written_total` | Number of pages written across all page writes (ie counting all pages written even if they are written in a single operation) | gauge | None +`wmi_memory_swap_page_operations_total` | Total number of swap page read and writes (PagesPersec) | gauge | None +`wmi_memory_swap_page_writes_total` | Number of disk page writes (a single write operation writing several pages is still only counted once) | gauge | None +`wmi_memory_pool_nonpaged_allocs_total` | The number of calls to allocate space in the nonpaged pool. The nonpaged pool is an area of system memory area for objects that cannot be written to disk, and must remain in physical memory as long as they are allocated | gauge | None +`wmi_memory_pool_nonpaged_bytes_total` | _Not yet documented_ | gauge | None +`wmi_memory_pool_paged_allocs_total` | _Not yet documented_ | gauge | None +`wmi_memory_pool_paged_bytes` | _Not yet documented_ | gauge | None +`wmi_memory_pool_paged_resident_bytes` | _Not yet documented_ | gauge | None +`wmi_memory_standby_cache_core_bytes` | _Not yet documented_ | gauge | None +`wmi_memory_standby_cache_normal_priority_bytes` | _Not yet documented_ | gauge | None +`wmi_memory_standby_cache_reserve_bytes` | _Not yet documented_ | gauge | None +`wmi_memory_system_cache_resident_bytes` | _Not yet documented_ | gauge | None +`wmi_memory_system_code_resident_bytes` | _Not yet documented_ | gauge | None +`wmi_memory_system_code_total_bytes` | _Not yet documented_ | gauge | None +`wmi_memory_system_driver_resident_bytes` | _Not yet documented_ | gauge | None +`wmi_memory_system_driver_total_bytes` | _Not yet documented_ | gauge | None +`wmi_memory_transition_faults_total` | _Not yet documented_ | gauge | None +`wmi_memory_transition_pages_repurposed_total` | _Not yet documented_ | gauge | None +`wmi_memory_write_copies_total` | The number of page faults caused by attempting to write that were satisfied by copying the page from elsewhere in physical memory | gauge | None + +### Example metric +_This collector does not yet have explained examples, we would appreciate your help adding them!_ + +## Useful queries +_This collector does not yet have any useful queries added, we would appreciate your help adding them!_ + +## Alerting examples +_This collector does not yet have alerting examples, we would appreciate your help adding them!_