System

This is the cog guide for the system cog. You will find detailed docs about usage and commands.

[p] is considered as your prefix.

Note

To use this cog, you will need to install and load it.

See the Getting my cogs page.

Usage

Get system metrics.

Most commands work on all OSes or omit certian information. See the help for individual commands for detailed limitations.

Commands

system

Note

This command is locked to the bot owner.

Syntax

[p]system

Description

Get information about your system metrics.

Most commands work on all OSes or omit certian information. See the help for individual commands for detailed limitations.

system cpu

Syntax

[p]system cpu

Description

Get metrics about the CPU.

This will show the CPU usage as a percent for each core, and frequency depending on platform. It will also show the time spent idle, user and system as well as uptime.

Platforms: Windows, Linux, Mac OS .. Note:: CPU frequency is nominal and overall on Windows and Mac OS,

on Linux it’s current and per-core.

system disk

Syntax

[p]system disk

Tip

Alias: system df

Description

Get infomation about disks connected to the system.

This will show the space used, total space, filesystem and mount point (if you’re on Linux make sure it’s not potentially sensitive if running the command a public space).

Platforms: Windows, Linux, Mac OS

Note

Mount point is basically useless on Windows as it’s the same as the drive name, though it’s still shown.

system mem

Syntax

[p]system mem

Tip

Aliases: system memory, system ram

Description

Get infomation about memory usage.

This will show memory available as a percent, memory used and available as well as the total amount. Data is provided for both physical and SWAP RAM.

Platforms: Windows, Linux, Mac OS

system network

Syntax

[p]system network

Tip

Alias: system net

Description

Get network stats. They may have overflowed and reset at some point.

Platforms: Windows, Linux, Mac OS

system processes

Syntax

[p]system processes

Tip

Alias: system proc

Description

Get an overview of the status of currently running processes.

Platforms: Windows, Linux, Mac OS

system sensors

Syntax

[p]system sensors [fahrenheit=False]

Tip

Aliases: system temp, system temperature, system fan, system fans

Description

Get sensor metrics.

This will return any data about temperature and fan sensors it can find. If there is no name for an individual sensor, it will use the name of the group instead.

Platforms: Linux

system top

Syntax

[p]system top

Tip

Aliases: system overview, system all

Description

Get an overview of the current system metrics, similar to top.

This will show CPU utilisation, RAM usage and uptime as well as active processes.

Platforms: Windows, Linux, Mac OS

Note

This command appears to be very slow in Windows.

system uptime

Syntax

[p]system uptime

Tip

Alias: system up

Description

Get the system boot time and how long ago it was.

Platforms: Windows, Linux, Mac OS

system users

Syntax

[p]system users

Description

Get information about logged in users.

This will show the user name, what terminal they’re logged in at, and when they logged in.

Platforms: Windows, Linux, Mac OS

Note

PID is not available on Windows. Terminal is usually Unknown