diff --git a/testing/perfdocs/generated/comment-zero-alert-number.png b/testing/perfdocs/generated/comment-zero-alert-number.png new file mode 100644 index 000000000000..987437aad8b2 Binary files /dev/null and b/testing/perfdocs/generated/comment-zero-alert-number.png differ diff --git a/testing/perfdocs/generated/mach-try-perf.rst b/testing/perfdocs/generated/mach-try-perf.rst index 1ccc90bbe404..0aef809bdf53 100644 --- a/testing/perfdocs/generated/mach-try-perf.rst +++ b/testing/perfdocs/generated/mach-try-perf.rst @@ -118,6 +118,19 @@ To use mach try perf simply call ``./mach try perf``. This will open an interfac Select the categories you'd like to run, hit enter, and wait for the tool to finish the pushes. **Note that it can take some time to do both pushes, and you might not see logging for some time.** +.. _Running Alert Tests: + +Running Alert Tests +------------------- + +To run all the tests that triggered a given alert, use ``./mach try perf --alert ``. **It's recommended to use this when working with performance alerts.** The alert number can be found in comment 0 on any alert bug `such as this one `_. As seen in the image below, the alert number can be found just above the summary table. + +.. image:: ./comment-zero-alert-number.png + :alt: Comment 0 containing an alert number just above the table. + :scale: 50% + :align: center + + Chrome and Android ------------------ diff --git a/testing/perfdocs/generated/standard-workflow.rst b/testing/perfdocs/generated/standard-workflow.rst index 9756adec4584..e874ecc7b8aa 100644 --- a/testing/perfdocs/generated/standard-workflow.rst +++ b/testing/perfdocs/generated/standard-workflow.rst @@ -56,6 +56,11 @@ For any additional questions, please reach out to us in the `#perftest `` to run the tests that alerted. After running the command, the standard workflow above still applies. See :ref:`Running Alert Tests` for more information on this. + Graphs View =========== diff --git a/testing/performance/mach-try-perf/perfdocs/comment-zero-alert-number.png b/testing/performance/mach-try-perf/perfdocs/comment-zero-alert-number.png new file mode 100644 index 000000000000..987437aad8b2 Binary files /dev/null and b/testing/performance/mach-try-perf/perfdocs/comment-zero-alert-number.png differ diff --git a/testing/performance/mach-try-perf/perfdocs/index.rst b/testing/performance/mach-try-perf/perfdocs/index.rst index 1ccc90bbe404..0aef809bdf53 100644 --- a/testing/performance/mach-try-perf/perfdocs/index.rst +++ b/testing/performance/mach-try-perf/perfdocs/index.rst @@ -118,6 +118,19 @@ To use mach try perf simply call ``./mach try perf``. This will open an interfac Select the categories you'd like to run, hit enter, and wait for the tool to finish the pushes. **Note that it can take some time to do both pushes, and you might not see logging for some time.** +.. _Running Alert Tests: + +Running Alert Tests +------------------- + +To run all the tests that triggered a given alert, use ``./mach try perf --alert ``. **It's recommended to use this when working with performance alerts.** The alert number can be found in comment 0 on any alert bug `such as this one `_. As seen in the image below, the alert number can be found just above the summary table. + +.. image:: ./comment-zero-alert-number.png + :alt: Comment 0 containing an alert number just above the table. + :scale: 50% + :align: center + + Chrome and Android ------------------ diff --git a/testing/performance/mach-try-perf/perfdocs/standard-workflow.rst b/testing/performance/mach-try-perf/perfdocs/standard-workflow.rst index 9756adec4584..e874ecc7b8aa 100644 --- a/testing/performance/mach-try-perf/perfdocs/standard-workflow.rst +++ b/testing/performance/mach-try-perf/perfdocs/standard-workflow.rst @@ -56,6 +56,11 @@ For any additional questions, please reach out to us in the `#perftest `` to run the tests that alerted. After running the command, the standard workflow above still applies. See :ref:`Running Alert Tests` for more information on this. + Graphs View ===========