Fork of graftorio

中文文档

visualize metrics from your factorio game in grafana

grafana is an open-source project for rendering time-series metrics. by using graftorio, you can create a dashboard with various charts monitoring aspects of your factorio factory. this dashboard is viewed using a web browser outside of the game client. (works great in a 2nd monitor!)

in order to use graftorio, you need to run the grafana software and a database called prometheus locally. graftorio automates this process using docker, or you can set these up by hand.

1. download the latest release, and extract it into the location you want to host the local database
2. install docker
   • if using windows, you will need to be running Windows 10 Pro
3. if using macOS or Linux, open the extracted docker-compose.yml in a text editor and uncomment the correct path to your factorio install
4. using a terminal, run docker-compose up inside the extracted directory
5. load localhost:3000 in a browser, don't need to login and prometheus is already the default datasource
6. launch factorio
7. install the "graftorio2" mod via the mods menu
8. load up your game, and see your statistics in the grafana dashboard
   • beginner instructions for building dashboards

to see if factorio is generating stats, confirm a game.prom file exists at the configured exporter volume directory. when opened, it should look something like this:

# HELP factorio_item_production_input items produced
# TYPE factorio_item_production_input gauge
factorio_item_production_input{force="player",name="burner-mining-drill"} 3
factorio_item_production_input{force="player",name="iron-chest"} 1

to see if prometheus is scraping the data, load localhost:9090/targets in a browser and confirm that the status is "UP"

to see if the grafana data source can read correctly, start a new dashboard and add a graph with the query factorio_item_production_input. the graph should render the total of every item produced in your game.