Metrics.md

Exported metrics

Many metrics are only added to the export list when their respective value first changes - you will not see train stats before you have placed your first train. This resets after each server restart, so if no trains have moved since the restart, no statistics for them will show up either.

Please read the warning regarding the cardinality of train metrics!

General

Name	Labels	Description
factorio_tick		Most recent game tick, divide by 60 for game time in seconds
factorio_seed	surface	The seed for the given surface
factorio_mods	name version	1 for each mod at its currently installed version

Players

Name	Labels	Description
factorio_connected_player_count		Count of currently connected players
factorio_total_player_count		Count of all players who were ever connected

Production

Items

Name	Labels	Description
factorio_item_production_input	force name	How many of each item have been produced in total by each force
factorio_item_production_output	force name	How many of each item have been used/consumed in total by each force

Fluids

Name	Labels	Description
factorio_fluid_production_input	force name	How much of each fluid has been produced in total by each force
factorio_fluid_production_output	force name	How much of each fluid has been used/consumed in total by each force

Energy

Name	Labels	Description
factorio_power_production_input	force name network surface	How much total power has been produced by each machine type in each network
factorio_power_production_output	force name network surface	How much total power has been consumed by each machine type in each network

Pollution

Name	Labels	Description
factorio_pollution_production_input	force name	How much pollution has been produced by which source in total by each force
factorio_pollution_production_output	force name	How much pollution has been consumed by which sink in total by each force

Evolution

Name	Labels	Description
factorio_evolution	force type	The current evolution factor (type == "total") for each force and its components (type != "total"). The current evolution factor is not the sum of its components! See the wiki for details.

Science

Name	Labels	Description
factorio_research_queue	force name level index	The progress of each research in the queue, with its associated level if infinite, for each force
factorio_items_launched_total	force name	How many of each item have been sent to space by each force

Trains

Important! Several train metrics have a very high cardinality. This means that you will very likely get many metrics, which can slow down your server during metric collection (see Settings>Scheduler timer to collect less often) and if you do not host your own metric backend (prometheus in our default case), can cost you a lot of money if unchecked! All train stats can be disabled in the settings to prevent this.

Histogram bucket sizes can also be adjusted in the settings.

Name	Labels	Description
factorio_train_trip_time	from to train_id	How long train_id took to go from from to to in seconds
factorio_train_wait_time	from to train_id	How long train_id had to wait while going from from to to in seconds
factorio_train_trip_time_groups_bucket factorio_train_trip_time_groups_sum factorio_train_trip_time_groups_count	from to train_id	Histogram for how long train_id took to go from from to to in seconds
factorio_train_wait_time_groups_bucket factorio_train_wait_time_groups_sum factorio_train_wait_time_groups_count	from to train_id	Histogram for how long train_id had to wait while going from from to to in seconds
factorio_train_direct_loop_time	a b	???TODO???
factorio_train_direct_loop_time_groups_bucket factorio_train_direct_loop_time_groups_sum factorio_train_direct_loop_time_groups_count	a b	???TODO???
factorio_train_arrival_time	station	How many seconds passed at station between the arrival of the last train the train before it
factorio_train_arrival_time_groups_bucket factorio_train_arrival_time_groups_sum factorio_train_arrival_time_groups_count	station	Histogram for how many seconds passed at station between the arrival of the two trains

Logistic Networks

Name	Labels	Description
factorio_logistic_network_all_construction_robots	force location (=surface) network	Total number of construction robots in the network
factorio_logistic_network_available_construction_robots	force location (=surface) network	Number of construction robots in the network available for a new job
factorio_logistic_network_all_logistic_robots	force location (=surface) network	Total number of construction robots in the network
factorio_logistic_network_available_logistic_robots	force location (=surface) network	Number of construction robots in the network available for a new job
factorio_logistic_network_robot_limit	force location (=surface) network	Maximum number of robot the network can work with
factorio_logistic_network_items	force location (=surface) network name	Number of item name in the network

Other

Name	Labels	Description
factorio_kill_count_input	force name	How many of each entity have been killed in total by each force
factorio_kill_count_output	force name	How many of each entity have been lost in total by each force
factorio_build_count_input	force name	How many of each entity have been placed in total by each force
factorio_build_count_output	force name	How many of each entity have been removed in total by each force

Mods

The following metrics are only available if their respective mod is installed.

YARM

Name	Labels	Description
factorio_yarm_site_amount	force name type	How much type remains in the site with name name
factorio_yarm_site_ore_per_minute	force name type	How much type is mined at the site with name name
factorio_yarm_site_remaining_permille	force name type	How much type is remaining (in permille) compared to the starting amount of site name