Monitor your servers from your phone. This is the agent you install on the server.
Monitee agent provide a GraphQL API to your computers hardware.
It publishes and monitors values from OSHI with the help of Spring. On Windows the information is supplemented with OpenHardwareMonitor with a bit of help from OhmJni4Net.
Query for:
- CPU usage & info
- Memory usage
- List running processes
- List all network interfaces
- Show info from sensors and fans
- Motherboard information
- Manage docker containers
- Manage systemd services
- Manage windows services
- Read logs from files, systemd journal and Windows events
- Browse and manage files in configured directories
Currently, you can monitor
- CPU load
- CPU temperature
- Memory usage
- Network up
- Network upload/download rate
- Drive space
- Drive read/write rate
- Process ID CPU or Memory
- Docker container in running state
- Connectivity
- External IP changed
GraphQL is available through the /graphql endpoint. Checkout the schema. There's also a set of sample queries in the sample-queries directory
A web-UI for trying out the GraphQL-API is also available at <IP>:8080/graphiql. If you don't want to expose this functionality. It can be disabled via the configuration.
graphQLPlayGround:
enabled: falseMonitee is two pieces: the app on your phone, and an agent you run on the server you want to watch. The agent does the work — install it first, then point the app at it.
- Docker Compose
- Docker
- Unraid
- TrueNAS Scale
- Home Assistant
- Deb package
- Command line
- Windows setup.exe
Install Monitee from Google Play and tap +. On your own network it usually finds the server by itself — the agent announces itself over DNS-SD, so there is often nothing to type at all.
The application expects a user config file (configuration.yml) and a spring configuration file (application.properties) in the /config directory. See the sample files in the /config repository directory.
By default, the Monitee agent will generate a self-signed certificate to enable HTTPS. This is to lower the barrier for encrypted traffic between the client and the server. Please note that using properly signed certificates is better. Let's Encrypt is a free and good alternative.
For convenience, the certificates are persisted using a java keystore. If you wish to re-generate the certificates, delete the keystorewww.jks file. But note that this will require re-adding the server in Monitee.
Setup
git clone [this repo] monitee-agent./gradlew runLicensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.