Skip to content

Commit 32169a1

Browse files
doc: fix spelling
1 parent 68b4950 commit 32169a1

File tree

6 files changed

+57
-32
lines changed

6 files changed

+57
-32
lines changed

.cspell.json

Lines changed: 13 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,8 @@
55
"enableGlobDot": true,
66
"language": "en",
77
"dictionaries": [
8-
"project-words"
8+
"project-words",
9+
"grid5000",
910
],
1011
"ignorePaths": [
1112
"*.toml",
@@ -21,6 +22,11 @@
2122
"name": "project-words",
2223
"path": ".cspell/project-words.txt",
2324
"addWords": true
25+
},
26+
{
27+
"name": "grid5000",
28+
"path": ".cspell/grid5000.txt",
29+
"addWords": true
2430
}
2531
],
2632
"languageSettings": [
@@ -29,7 +35,8 @@
2935
"ignoreRegExpList": [
3036
"markdown_code_block",
3137
"markdown_inline_code",
32-
"name_surname"
38+
"name_surname",
39+
"math_equation_latex",
3340
]
3441
}
3542
],
@@ -45,6 +52,10 @@
4552
{
4653
"name": "name_surname",
4754
"pattern": "[A-Z]\\w+ [A-Z]\\w+"
55+
},
56+
{
57+
"name": "math_equation_latex",
58+
"pattern": "\\$\\$.+\\$\\$"
4859
}
4960
],
5061
"enabled": true

.cspell/grid5000.txt

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,9 @@
1+
chiroptera
2+
neowise
3+
oar
4+
paradoxe
5+
quarch
6+
quarchpy
7+
sagittaire
8+
servan
9+
wattmetre

.cspell/project-words.txt

Lines changed: 17 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,15 +1,24 @@
1+
acpi
12
Alumet
23
Atos
4+
downsampling
35
Eviden
4-
rapl
5-
RAPL
6-
rustup
7-
libc
86
Jetson
9-
downsampling
7+
kwollect
8+
libc
109
mdbook
11-
pagetoc
12-
slurm
13-
oar
10+
milli
1411
nvml
12+
pagetoc
13+
powercap
1514
powermeters
15+
rapl
16+
RAPL
17+
rustup
18+
SCPI
19+
slurm
20+
superchip
21+
superchips
22+
tracepoints
23+
UCUM
24+
wattmeters

src/plugins/1_sources/nvidia-jetson.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -19,9 +19,9 @@ Depending on the hardware, some metrics may or may not be collected.
1919

2020
|Name|Type|Unit|Description|Attributes|
2121
|----|----|----|-----------|----------|
22-
|`input_current`| u64 | mA (milli-Ampere) | current intensity on the channel's line | see below |
23-
|`input_voltage`| u64 | mV (milli-Volt)| current voltage on the channel's line | see below |
24-
|`input_power` | u64 | mW (milli-Watt)| instantaneous electrical power on the channel's line | see below |
22+
|`input_current`| u64 | mA (milliAmpere) | current intensity on the channel's line | see below |
23+
|`input_voltage`| u64 | mV (milliVolt)| current voltage on the channel's line | see below |
24+
|`input_power` | u64 | mW (milliWatt)| instantaneous electrical power on the channel's line | see below |
2525

2626
### Attributes
2727

src/plugins/1_sources/raw-cgroups.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -43,7 +43,7 @@ poll_interval = "1s"
4343
The version of the control groups and the mount point of the cgroupfs are automatically detected.
4444

4545
The plugin watches for the creation and deletion of cgroups.
46-
With cgroup v2, the detection is almost instantaneous, because it relies on inotify.
46+
With cgroup v2, the detection is almost instantaneous, because it relies on `inotify`.
4747
With cgroup v1, however, cgroups are repeatedly polled. The refresh interval is `30s`, and it is currently not possible to change it in the plugin's configuration.
4848

4949
## More information

src/plugins/2_transforms/energy-estimation-tdp.md

Lines changed: 14 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -12,27 +12,19 @@ Refer to the [wikipedia page of TDP](https://en.wikipedia.org/wiki/Thermal_desig
1212

1313
In the first version of the plugin, we consider only the TDP of the CPU.
1414

15-
This plugin requires the cgroupv2 input plugin (k8s) as it needs the input measurements of cgroups v2.
15+
This plugin requires the cgroupv2 input plugin (k8s) as it needs the input measurements of cgroups v2.
1616

1717
The estimation calculation is done using the following formula:
1818

1919
$$\Large Energy=\frac{cgroupv2*cpu total usage*nb\_vcpu*TDP}{10^6*pooling\_interval*nb\_cpu}$$
2020

21-
cgroupv2_cpu_total_usage: total usage of CPU in micro seconds for a pod
22-
nb_vcpu: number of virtual CPU of the hosting machine where pod is running
23-
nb_cpu: number of physical CPU of the hosting machine where pod is running
24-
polling_interval: polling interval of cgroupv2 input plugin
21+
- `cgroupv2_cpu_total_usage`: total usage of CPU in micro seconds for a pod
22+
- `nb_vcpu`: number of virtual CPU of the hosting machine where pod is running
23+
- `nb_cpu`: number of physical CPU of the hosting machine where pod is running
24+
- `polling_interval`: polling interval of cgroupv2 input plugin
2525

2626
## Energy estimation tdp plugin
2727

28-
### How to use
29-
30-
Just compile the app-agent of the alumet's github repository.
31-
32-
```bash
33-
cargo run
34-
```
35-
3628
The binary created by the compilation will be found under the target repository.
3729

3830
### Prepare your environment
@@ -45,24 +37,28 @@ To work this plugin needs k8s plugin configured, so the needed things are relate
4537

4638
### Configuration
4739

40+
```toml
4841
[plugins.EnergyEstimationTdpPlugin]
4942
poll_interval = "30s"
5043
tdp = 100.0
5144
nb_vcpu = 1.0
5245
nb_cpu = 1.0
46+
```
5347

54-
pool_interval: must be identical to the poll_interval of input k8s plugin. Default value is 1s.
55-
56-
nb_vcpu: number of virtual cpu allocated to the virtual machine in case of kubernetes nodes are virtual machine. Using the kubectl get node command, you can retrieve the number of vcpu. If the kubernetes nodes are physical machine, assign it to value 1. Default value is 1.
48+
- `pool_interval`: must be identical to the poll_interval of input k8s plugin. Default value is 1s.
49+
- `nb_vcpu`: number of virtual cpu allocated to the virtual machine in case of kubernetes nodes are virtual machine. Using the kubectl get node command, you can retrieve the number of virtual cores. If the kubernetes nodes are physical machine, assign it to value 1. Default value is 1.
5750

5851
To get the CPU capacity of a kubernetes node, execute the following command:
52+
53+
```sh
5954
kubectl describe node <node name> | grep cpu -B 2
6055
Hostname: <node name>
6156
Capacity:
6257
cpu: 32
58+
```
6359

64-
nb_cpu: number of physical cpu of the hosted machine. Using the lscpu or hwinfo, you can retrieve the number of cpu. If the kubernetes nodes are physical machine, assign it to value 1. Default value is 1.
60+
- `nb_cpu`: number of physical cpu of the hosted machine. Using the `lscpu` or `hwinfo`, you can retrieve the number of cpu. If the kubernetes nodes are physical machine, assign it to value 1. Default value is 1.
6561

66-
tdp: Thermal Design power; each CPU has a calculated thermal design value; the value can be find on internet (usually on CPU manufacturer); you need the exact CPU family (using command lscpu or hwinfo). For example, for Intel® Xeon® D Processor, family D-2183IT, the tpd can be found [it's intel documentation page](https://ark.intel.com/content/www/us/en/ark/products/136441/intel-xeon-d-2183it-processor-22m-cache-2-20-ghz.html)
62+
tdp: Thermal Design power; each CPU has a calculated thermal design value; the value can be find on internet (usually on CPU manufacturer); you need the exact CPU family (using command `lscpu` or `hwinfo`). For example, for Intel® Xeon® D Processor, family D-2183IT, the tpd can be found [it's intel documentation page](https://ark.intel.com/content/www/us/en/ark/products/136441/intel-xeon-d-2183it-processor-22m-cache-2-20-ghz.html)
6763
tdp value is 100W.
6864
Default value is 100.

0 commit comments

Comments
 (0)