You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: pages/instances/reference-content/understanding-qemu-guest-agent.mdx
+27Lines changed: 27 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -15,6 +15,28 @@ This page provides essential insights into this mechanism.
15
15
This documentation page does not apply to Instances running the Microsoft Windows operating system.
16
16
</Message>
17
17
18
+
## What is the QGA?
19
+
20
+
The QEMU Guest Agent (QGA) is a daemon designed to run inside virtual machines, enabling communication between the guest operating system and the QEMU hypervisor. It supports tasks such as system configuration and resource monitoring.
21
+
22
+
The QGA source code is publicly available in the [QEMU repository on GitLab](https://gitlab.com/qemu-project/qemu/-/blob/master/docs/interop/qemu-ga.rst).
23
+
24
+
<Messagetype="note">
25
+
In addition to the QGA, another daemon is preinstalled on recently created Instances: `scaleway-vmagent`. This agent was developed by Scaleway's engineering teams and is used to send metrics about your VM to [Cockpit](/cockpit/) to monitor the status of your Instance.
26
+
You can find the source code of the agent on Scaleway's [Launchpad repository](https://launchpad.net/~scaleway/+archive/ubuntu/stable/+packages).
27
+
</Message>
28
+
29
+
## Which tasks are allowed for the QGA?
30
+
31
+
Scaleway has intentionally restricted the QGA to the following allowed tasks (configured in `/etc/qemu/qemu-ga.conf`):
32
+
33
+
*`guest-file-close`
34
+
*`guest-file-open`
35
+
*`guest-file-write`
36
+
*`guest-ping`
37
+
38
+
All other Remote Procedure Calls (RPCs) are disabled to limit the scope of external execution from the QEMU hypervisor.
39
+
18
40
## What are the features provided by QGA?
19
41
20
42
Running the QEMU Guest Agent (QGA) on your Instance currently enables the following feature:
@@ -23,6 +45,11 @@ Running the QEMU Guest Agent (QGA) on your Instance currently enables the follow
23
45
24
46
Additional features may be added in the future.
25
47
48
+
## What is the performance impact of running the QGA inside my VM?
49
+
50
+
The performance impact of running the QGA is negligible. The agent consumes very little RAM (<5MB)andCPU(<0.1%),andthereisnomeasurableI/Oornetworkoverheadwhenidle.
0 commit comments