Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[pull] master from netdata:master #229

Merged
merged 4 commits into from
Dec 11, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion packaging/installer/kickstart.sh
Original file line number Diff line number Diff line change
Expand Up @@ -1476,7 +1476,7 @@ pkg_installed() {
netdata_avail_check() {
case "${DISTRO_COMPAT_NAME}" in
debian|ubuntu)
env DEBIAN_FRONTEND=noninteractive apt-cache policy netdata | grep -q repo.netdata.cloud/repos/;
env DEBIAN_FRONTEND=noninteractive apt-cache policy netdata | grep -q "repo.*.netdata.cloud/repos/";
return $?
;;
centos|fedora|ol|amzn)
Expand Down
13 changes: 7 additions & 6 deletions packaging/installer/methods/packages.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,7 @@ and fail if it cannot do so.

## Manual setup of RPM packages

Netdata’s official RPM repositories are hosted at <https://repository.netdata.cloud/repos>. We provide four groups of
Netdata’s official RPM repositories are hosted at <https://repository.netdata.cloud/repos/index.html>. We provide four groups of
repositories at that top level:

- `stable`: Contains packages for stable releases of the Netdata Agent.
Expand Down Expand Up @@ -46,9 +46,10 @@ current key fingerprint is `6588FDD7B14721FE7C3115E6F9177B5265F56346`. The assoc
`https://repository.netdata.cloud/netdatabot.gpg.key`.

If you are explicitly configuring a system to use our repositories, the recommended setup is to download the
appropriate repository configuration package from <https://repository.netdata.cloud/repos/repoconfig> and install it
directly on the target system using the system package manager. This will ensure any packages needed to use the
repository are also installed, and will help enable a seamless transition if we ever need to change our infrastructure.
appropriate repository configuration package from <https://repository.netdata.cloud/repos/repoconfig/index.html>
and install it directly on the target system using the system package manager. This will ensure any packages
needed to use the repository are also installed, and will help enable a seamless transition if we ever need to
change our infrastructure.

> **Note**
>
Expand All @@ -59,7 +60,7 @@ repository are also installed, and will help enable a seamless transition if we

## Manual setup of DEB packages

Netdata’s official DEB repositories are hosted at <https://repository.netdata.cloud/repos>. We provide four groups of
Netdata’s official DEB repositories are hosted at <https://repository.netdata.cloud/repos/index.html>. We provide four groups of
repositories at that top level:

- `stable`: Contains packages for stable releases of the Netdata Agent.
Expand Down Expand Up @@ -102,7 +103,7 @@ current key fingerprint is `6588FDD7B14721FE7C3115E6F9177B5265F56346`. The assoc
`https://repository.netdata.cloud/netdatabot.gpg.key`.

If you are explicitly configuring a system to use our repositories, the recommended setup is to download the
appropriate repository configuration package from <https://repository.netdata.cloud/repos/repoconfig> and install it
appropriate repository configuration package from <https://repository.netdata.cloud/repos/repoconfig/index.html> and install it
directly on the target system using the system package manager. This will ensure any packages needed to use the
repository are also installed, and will help enable a seamless transition if we ever need to change our infrastructure.

Expand Down
2 changes: 2 additions & 0 deletions src/collectors/COLLECTORS.md
Original file line number Diff line number Diff line change
Expand Up @@ -1167,6 +1167,8 @@ If you don't see the app/service you'd like to monitor in this list:

- [NET Framework](https://github.com/netdata/netdata/blob/master/src/collectors/windows.plugin/integrations/net_framework.md)

- [Physical and Logical Disk Performance Metrics](https://github.com/netdata/netdata/blob/master/src/collectors/windows.plugin/integrations/physical_and_logical_disk_performance_metrics.md)

- [Processor](https://github.com/netdata/netdata/blob/master/src/collectors/windows.plugin/integrations/processor.md)

- [Semaphore statistics](https://github.com/netdata/netdata/blob/master/src/collectors/windows.plugin/integrations/semaphore_statistics.md)
Expand Down
2 changes: 1 addition & 1 deletion src/collectors/windows.plugin/integrations/hyper-v.md
Original file line number Diff line number Diff line change
Expand Up @@ -58,7 +58,7 @@ The scope defines the instance that the metric belongs to. An instance is unique



### Per Hyper-V instance
### Per Hyper-V

These metrics refer to the Hyper-V instance.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -58,7 +58,7 @@ The scope defines the instance that the metric belongs to. An instance is unique



### Per Memory statistics instance
### Per System

These metrics refer to the entire system.

Expand Down
Original file line number Diff line number Diff line change
@@ -0,0 +1,168 @@
<!--startmeta
custom_edit_url: "https://github.com/netdata/netdata/edit/master/src/collectors/windows.plugin/integrations/physical_and_logical_disk_performance_metrics.md"
meta_yaml: "https://github.com/netdata/netdata/edit/master/src/collectors/windows.plugin/metadata.yaml"
sidebar_label: "Physical and Logical Disk Performance Metrics"
learn_status: "Published"
learn_rel_path: "Collecting Metrics/Windows Systems"
most_popular: False
message: "DO NOT EDIT THIS FILE DIRECTLY, IT IS GENERATED BY THE COLLECTOR'S metadata.yaml FILE"
endmeta-->

# Physical and Logical Disk Performance Metrics


<img src="https://netdata.cloud/img/windows.svg" width="150"/>


Plugin: windows.plugin
Module: PerflibStorage

<img src="https://img.shields.io/badge/maintained%20by-Netdata-%2300ab44" />

## Overview

Detailed statistics for all disk devices and volumes.


It queries 'LogicalDisk' and 'PhysicalDisk' objects from Perflib in order to gather the metrics.


This collector is only supported on the following platforms:

- windows

This collector only supports collecting metrics from a single instance of this integration.


### Default Behavior

#### Auto-Detection

The collector automatically detects all of the metrics, no further configuration is required.


#### Limits

The default configuration for this integration does not impose any limits on data collection.

#### Performance Impact

The default configuration for this integration is not expected to impose a significant performance impact on the system.


## Metrics

Metrics grouped by *scope*.

The scope defines the instance that the metric belongs to. An instance is uniquely identified by a set of labels.



### Per System

These metrics refer to the entire System.

This scope has no labels.

Metrics:

| Metric | Dimensions | Unit |
|:------|:----------|:----|
| system.io | reads, writes | KiB/s |

### Per Logical Disk

These metrics refer to Logical Disks.

Labels:

| Label | Description |
|:-----------|:----------------|
| mount_point | Drive letter or mount point path assigned by Windows (e.g., 'C:', 'D:'). |
| driver_type | Classification of the disk device (e.g., norootdir, removable, cdrom, ramdisk). |
| filesystem | File system format used on the volume (e.g., NTFS, FAT32). |
| rw_mode | Current read/write permissions status of the volume (read-only access, read and write access). |

Metrics:

| Metric | Dimensions | Unit |
|:------|:----------|:----|
| disk.space | avail, used | GiB |

### Per Physical Disk

These metrics refer to Physical Disks.

Labels:

| Label | Description |
|:-----------|:----------------|
| mount_point | Drive letter or mount point path assigned by Windows (e.g., 'C:', 'D:'). |
| device | Manufacturer model name. |
| model | The device model. |
| device_id | Unique hardware identifier for the storage device within the system. |

Metrics:

| Metric | Dimensions | Unit |
|:------|:----------|:----|
| disk.io | reads, writes | KiB/s |
| disk.avgsz | reads, writes | KiB/operation |
| disk.ops | reads, writes | operations/s |
| disk.split | discards | operations/s |
| disk.await | reads, writes | milliseconds/operation |
| disk.svctm | svctm | milliseconds/operation |
| disk.util | utilization | percent |
| disk.busy | busy | milliseconds |
| disk.iotime | reads, writes | milliseconds/s |
| disk.qops | operations | operations |



## Alerts

There are no alerts configured by default for this integration.


## Setup

### Prerequisites

No action required.

### Configuration

#### File

The configuration file name for this integration is `netdata.conf`.
Configuration for this specific integration is located in the `[plugin:windows]` section within that file.

The file format is a modified INI syntax. The general structure is:

```ini
[section1]
option1 = some value
option2 = some other value

[section2]
option3 = some third value
```
You can edit the configuration file using the [`edit-config`](https://github.com/netdata/netdata/blob/master/docs/netdata-agent/configuration/README.md#edit-a-configuration-file-using-edit-config) script from the
Netdata [config directory](https://github.com/netdata/netdata/blob/master/docs/netdata-agent/configuration/README.md#the-netdata-config-directory).

```bash
cd /etc/netdata 2>/dev/null || cd /opt/netdata/etc/netdata
sudo ./edit-config netdata.conf
```
#### Options



| Name | Description | Default | Required |
|:----|:-----------|:-------|:--------:|
| PerflibStorage | An option to enable or disable the data collection. | yes | no |

#### Examples
There are no configuration examples.


2 changes: 1 addition & 1 deletion src/collectors/windows.plugin/integrations/processor.md
Original file line number Diff line number Diff line change
Expand Up @@ -58,7 +58,7 @@ The scope defines the instance that the metric belongs to. An instance is unique



### Per Processor instance
### Per System

These metrics refer to the entire system.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -62,7 +62,7 @@ The scope defines the instance that the metric belongs to. An instance is unique



### Per Semaphore statistics instance
### Per System

These metrics refer to the entire system.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -58,7 +58,7 @@ The scope defines the instance that the metric belongs to. An instance is unique



### Per System statistics instance
### Per System

These metrics refer to the entire system.

Expand Down
Loading
Loading