Named Runners
Github Actions provides the ability to use human-readable runner names, and Currents displays these in the dashboard, allowing you to see which runner executed each spec file.
The typical method for creating a matrix strategy for runners in Github Actions is as follows:
matrix:
shard: [1/3, 2/3, 3/3]
However, there are several ways to achieve this, such as naming the machines with human-readable names like this:
matrix:
include:
- runner_name: "Runner 1"
shard: 1/2
- runner_name: "Runner 2"
shard: 2/2
This creates jobs that looks like this in Github Actions:

The final step is to visualize this in the Currents dashboard, which can be done by passing the runner name into the CURRENTS_MACHINE_ID environment variable:
- name: Run Playwright tests
env:
CURRENTS_MACHINE_ID: ${{ matrix.runner_name }}
run: npx pwc --key ${{secrets.CURRENTS_RECORD_KEY}} --project-id ${{secrets.CURRENTS_PROJECT_ID}} --ci-build-id ${{ github.repository }}-${{ github.run_id }}-${{ github.run_attempt}} --shard ${{ matrix.shard }}
The machineId
will now be visible in the Currents dashboard for each spec file, making it possible to identify which machine or job executed a specific spec file.

Here is a complete example of a Github Action yaml file with this setup:
It is also possible to add a dynamic number of named runners by including an extra job in the workflow:
generate-matrix:
runs-on: ubuntu-latest
outputs:
matrix: ${{ steps.set-matrix.outputs.matrix }}
steps:
- name: Set number of shards
id: set-shards
run: echo "SHARDS=5" >> $GITHUB_ENV
- name: Generate matrix
id: set-matrix
run: |
SHARDS=${SHARDS:-2} # Default to 2 if not set
MATRIX="{\"include\":["
for i in $(seq 1 $SHARDS); do
if [ $i -gt 1 ]; then MATRIX="$MATRIX,"; fi
MATRIX="$MATRIX{\"runner_name\":\"MyRunner $i\",\"shard\":\"$i/$SHARDS\"}"
done
MATRIX="$MATRIX]}"
echo "matrix=$MATRIX" >> "$GITHUB_OUTPUT"
It is only needed to update run: echo "SHARDS=5" >> $GITHUB_ENV
into the shards number is required.
A complete example can be found here:
Last updated
Was this helpful?