Auto-tools/Projects/Pulse/Exchanges: Difference between revisions

Latest revision as of 18:26, 10 May 2019

This page is meant to be a list of exchanges available on pulse.mozilla.org. If exchanges you are publishing isn't listed here, please add them. Your description doesn't have to be long, this is just give an overview of which exchanges is available on pulse, so that people can build tools on top of them. If you have additional documentation available, this is also a good place to put a link.

Treeherder

New Result-Sets

exchange(prod): exchange/treeherder/v1/new-result-set
exchange(stage): exchange/treeherder-stage/v1/new-result-set
maintainer: mdoglio@mozilla.com
description: Messages about new result-sets. These messages include the revision_hash, and can be used to add additional jobs to a treeherder result-set. The exchange for stage is operational as of writing.

Job Actions

exchange(prod): exchange/treeherder/v1/job-actions
exchange(stage): exchange/treeherder-stage/v1/job-actions
maintainer: mdoglio@mozilla.com
description: Messages about retrigger/cancel actions on jobs. Includes requester (an email address) and job_id/job_guid to fetch details about the job itself. The exchange for stage is operational as of writing.

Resultset Actions

exchange(prod): exchange/treeherder/v1/resultset-runnable-job-actions
exchange(stage): exchange/treeherder-stage/v1/resultset-runnable-job-actions
maintainer: mdoglio@mozilla.com
description: Messages for a push (e.g. "add new jobs"). Sample:

NOTE: Beware, the following sample was copied from tc's pulse-inspector and I could not access to the raw value. I hand edited the structure.

{
  u"requested_jobs": [u'0:desktop-test-linux64/opt-reftest-1', u'Windows 7 VM-GFX 32-bit try debug test mochitest-1'],
  u"resultset_id": u"117941",
  u"timestamp": 1471878682.08,
  u"project": u"try",
  u"version": 1,
  u"requester": "armenzg@mozilla.com",
  u"decisionTaskID": "OpXU-JkRRpW96DEgCoQo2g"
}

Simple Bugzilla

exchange: exchange/bugzilla/simple
maintainer: mcote@mozilla.com
description: Notifications of Bugzilla bug updates. See BMO/ChangeNotificationSystem.

hg.mozilla.org

exchange: exchange/hgpushes/v2
maintainer: gps@Mozilla.com
description: See v-c-t docs

TaskCluster

Taskcluster publishes events to pulse for just about everything that goes on. For more details see the Taskcluster Reference Docs.

Firefox Test Engineering

exchange: exchange/fxtesteng/jobs
maintainer: dhunt@mozilla.com
description: Treeherder consumable job information created from automated tests.

@@ Line 1: / Line 1: @@
 This page is meant to be a list of exchanges available on <code>pulse.mozilla.org</code>. If exchanges you are publishing isn't listed here, please add them. Your description doesn't have to be long, this is just give an overview of which exchanges is available on pulse, so that people can build tools on top of them. If you have additional documentation available, this is also a good place to put a link.
-'''Example entry'''
-<pre>
-== Notifications About Jonas' Lunch ==
-;exchange: [https://tools.taskcluster.net/pulse-inspector/#!%28%28exchange:exchange/jonasfj/lunch-notifications,routingKeyPattern:%23%29%29 <code>exchange/jonasfj/lunch-notifications</code>]
-;maintainer: jonasfj@mozilla.com
-;description: Exchange where I publish JSON messages about my lunch every day.
-</pre>
 == Treeherder ==
 === New Result-Sets ===
-;exchange(prod): [https://tools.taskcluster.net/pulse-inspector/#!%28%28exchange:exchange/treeherder/v1/new-result-set,routingKeyPattern:%23%29%29 <code>exchange/treeherder/v1/new-result-set</code>]
+;exchange(prod): [https://tools.taskcluster.net/pulse-inspector?bindings%5B0%5D%5Bexchange%5D=exchange%2Ftreeherder%2Fv1%2Fnew-result-set&bindings%5B0%5D%5BroutingKeyPattern%5D=%23 <code>exchange/treeherder/v1/new-result-set</code>]
-;exchange(stage): [https://tools.taskcluster.net/pulse-inspector/#!%28%28exchange:exchange/treeherder-stage/v1/new-result-set,routingKeyPattern:%23%29%29 <code>exchange/treeherder-stage/v1/new-result-set</code>]
+;exchange(stage): [https://tools.taskcluster.net/pulse-inspector?bindings%5B0%5D%5Bexchange%5D=exchange%2Ftreeherder-stage%2Fv1%2Fnew-result-set&bindings%5B0%5D%5BroutingKeyPattern%5D=%23 <code>exchange/treeherder-stage/v1/new-result-set</code>]
 ;maintainer: mdoglio@mozilla.com
 ;description: Messages about new result-sets. These messages include the <code>revision_hash</code>, and can be used to add additional jobs to a treeherder result-set. The exchange for stage is operational as of writing.
 === Job Actions ===
-;exchange(prod): [https://tools.taskcluster.net/pulse-inspector/#!%28%28exchange:exchange/treeherder/v1/job-actions,routingKeyPattern:%23%29%29 <code>exchange/treeherder/v1/job-actions</code>]
+;exchange(prod): [https://tools.taskcluster.net/pulse-inspector?bindings%5B0%5D%5Bexchange%5D=exchange%2Ftreeherder%2Fv1%2Fjob-actions&bindings%5B0%5D%5BroutingKeyPattern%5D=%23 <code>exchange/treeherder/v1/job-actions</code>]
-;exchange(stage): [https://tools.taskcluster.net/pulse-inspector/#!%28%28exchange:exchange/treeherder-stage/v1/job-actions,routingKeyPattern:%23%29%29 <code>exchange/treeherder-stage/v1/job-actions</code>]
+;exchange(stage): [https://tools.taskcluster.net/pulse-inspector?bindings%5B0%5D%5Bexchange%5D=exchange%2Ftreeherder-stage%2Fv1%2Fjob-action&bindings%5B0%5D%5BroutingKeyPattern%5D=%23 <code>exchange/treeherder-stage/v1/job-actions</code>]
 ;maintainer: mdoglio@mozilla.com
 ;description: Messages about retrigger/cancel actions on jobs. Includes requester (an email address) and job_id/job_guid to fetch details about the job itself. The exchange for stage is operational as of writing.
 === Resultset Actions ===
-;exchange(prod): [https://tools.taskcluster.net/pulse-inspector/#!%28%28exchange:exchange/treeherder/v1/resultset-runnable-job-actions,routingKeyPattern:%23%29%29 <code>exchange/treeherder/v1/resultset-runnable-job-actions</code>]
+;exchange(prod): [https://tools.taskcluster.net/pulse-inspector?bindings%5B0%5D%5Bexchange%5D=exchange%2Ftreeherder%2Fv1%2Fresultset-runnable-job-actions&bindings%5B0%5D%5BroutingKeyPattern%5D=%23 <code>exchange/treeherder/v1/resultset-runnable-job-actions</code>]
-;exchange(stage): [https://tools.taskcluster.net/pulse-inspector/#!%28%28exchange:exchange/treeherder-stage/v1/resultset-runnable-job-actions,routingKeyPattern:%23%29%29 <code>exchange/treeherder-stage/v1/resultset-runnable-job-actions</code>]
+;exchange(stage): [https://tools.taskcluster.net/pulse-inspector?bindings%5B0%5D%5Bexchange%5D=exchange%2Ftreeherder-stage%2Fv1%2Fresultset-runnable-job-actions&bindings%5B0%5D%5BroutingKeyPattern%5D=%23 <code>exchange/treeherder-stage/v1/resultset-runnable-job-actions</code>]
 ;maintainer: mdoglio@mozilla.com
 ;description: Messages for a push (e.g. "add new jobs"). Sample:
@@ Line 41: / Line 33: @@
 }
 </pre>
-== Pulse Test ==
-;exchange: [https://tools.taskcluster.net/pulse-inspector/#!%28%28exchange:exchange/pulse/test,routingKeyPattern:%23%29%29 <code>exchange/pulse/test</code>]
-;maintainer: mcote@mozilla.com
-;description: A simple heartbeat message published every minute.  This can be used to test if your client is working, although subscribing to any high-traffic exchange (e.g. BuildBot) would work as well.  Note that this is currently broken.
 == Simple Bugzilla ==
-;exchange: [https://tools.taskcluster.net/pulse-inspector/#!%28%28exchange:exchange/bugzilla/simple,routingKeyPattern:%23%29%29 <code>exchange/bugzilla/simple</code>]
+;exchange: [https://tools.taskcluster.net/pulse-inspector?bindings%5B0%5D%5Bexchange%5D=exchange%2Fbugzilla%2Fsimple&bindings%5B0%5D%5BroutingKeyPattern%5D=%23 <code>exchange/bugzilla/simple</code>]
 ;maintainer: mcote@mozilla.com
 ;description: Notifications of Bugzilla bug updates.  See [[BMO/ChangeNotificationSystem]].
-== BuildBot ==
-;exchange: [https://tools.taskcluster.net/pulse-inspector/#!%28%28exchange:exchange/build/,routingKeyPattern:%23%29%29 <code>exchange/build/</code>]
-;maintainer: catlee@mozilla.com
-;description: Notifications of builds and test runs.  See [[Auto-tools/Projects/Pulse#Consuming_Buildbot_messages]].
-== Normalized BuildBot ==
-;exchange: [https://tools.taskcluster.net/pulse-inspector/#!%28%28exchange:exchange/build/normalized,routingKeyPattern:%23%29%29 <code>exchange/build/normalized</code>]
-;maintainer: jgriffin@mozilla.com
-;description: See [[Auto-tools/Projects/Pulse#Consuming_Buildbot_messages]].
 == hg.mozilla.org ==
-;exchange: [https://tools.taskcluster.net/pulse-inspector/#!((exchange:exchange/hgpushes/v1,routingKeyPattern:%23)) <code>exchange/hgpushes/v1</code>]
+;exchange: [https://tools.taskcluster.net/pulse-inspector?bindings%5B0%5D%5Bexchange%5D=exchange%2Fhgpushes%2Fv2&bindings%5B0%5D%5BroutingKeyPattern%5D=%23 <code>exchange/hgpushes/v2</code>]
 ;maintainer: gps@Mozilla.com
 ;description: See [https://mozilla-version-control-tools.readthedocs.io/en/latest/hgmo/notifications.html v-c-t docs]
-== MozReview ==
-;exchange: [https://tools.taskcluster.net/pulse-inspector/#!((exchange:exchange/mozreview/,routingKeyPattern:%23))<code>exchange/mozreview/</code>]
-;maintainer: mcote@mozilla.com
-;description: See [https://mozilla-version-control-tools.readthedocs.io/en/latest/mozreview/notifications.html v-c-t docs]
 == TaskCluster ==
-=== Queue: Task Defined ===
+Taskcluster publishes events to pulse for just about everything that goes on.  For more details see the [https://docs.taskcluster.net/docs/reference Taskcluster Reference Docs].
-;exchange: [https://tools.taskcluster.net/pulse-inspector/#!%28%28exchange:exchange/taskcluster-queue/v1/task-defined,routingKeyPattern:%23%29%29 <code>exchange/taskcluster-queue/v1/task-defined</code>]
-;maintainer: jonasfj@mozilla.com
-;description: Notifications of new task definitions, for details see [http://docs.taskcluster.net/queue/exchanges/#taskDefined official documentation]
-=== Queue: Task Pending ===
-;exchange: [https://tools.taskcluster.net/pulse-inspector/#!%28%28exchange:exchange/taskcluster-queue/v1/task-pending,routingKeyPattern:%23%29%29 <code>exchange/taskcluster-queue/v1/task-pending</code>]
-;maintainer: jonasfj@mozilla.com
-;description: Notifications of pending tasks, for details see [http://docs.taskcluster.net/queue/exchanges/#taskPending official documentation]
-=== Queue: Task Running ===
-;exchange: [https://tools.taskcluster.net/pulse-inspector/#!%28%28exchange:exchange/taskcluster-queue/v1/task-running,routingKeyPattern:%23%29%29 <code>exchange/taskcluster-queue/v1/task-running</code>]
-;maintainer: jonasfj@mozilla.com
-;description: Notifications of running tasks, for details see [http://docs.taskcluster.net/queue/exchanges/#taskRunning official documentation]
-=== Queue: Artifact Creation ===
-;exchange: [https://tools.taskcluster.net/pulse-inspector/#!%28%28exchange:exchange/taskcluster-queue/v1/artifact-created,routingKeyPattern:%23%29%29 <code>exchange/taskcluster-queue/v1/artifact-created</code>]
-;maintainer: jonasfj@mozilla.com
-;description: Notifications of new artifacts, for details see [http://docs.taskcluster.net/queue/exchanges/#artifactCreated official documentation]
-=== Queue: Task Completed ===
-;exchange: [https://tools.taskcluster.net/pulse-inspector/#!%28%28exchange:exchange/taskcluster-queue/v1/task-completed,routingKeyPattern:%23%29%29 <code>exchange/taskcluster-queue/v1/task-completed</code>]
-;maintainer: jonasfj@mozilla.com
-;description: Notifications of completed tasks, for details see [http://docs.taskcluster.net/queue/exchanges/#taskCompleted official documentation]
-=== Queue: Task Failed ===
-;exchange: [https://tools.taskcluster.net/pulse-inspector/#!%28%28exchange:exchange/taskcluster-queue/v1/task-failed,routingKeyPattern:%23%29%29 <code>exchange/taskcluster-queue/v1/task-failed</code>]
-;maintainer: jonasfj@mozilla.com
-;description: Notifications of failed tasks, for details see [http://docs.taskcluster.net/queue/exchanges/#taskFailed official documentation]
-=== Queue: Task Exception ===
-;exchange: [https://tools.taskcluster.net/pulse-inspector/#!%28%28exchange:exchange/taskcluster-queue/v1/task-exception,routingKeyPattern:%23%29%29 <code>exchange/taskcluster-queue/v1/task-exception</code>]
-;maintainer: jonasfj@mozilla.com
-;description: Notifications of tasks that could not run, for details see [http://docs.taskcluster.net/queue/exchanges/#taskException official documentation]
-=== Scheduler: Task-Graph Running ===
-;exchange: [https://tools.taskcluster.net/pulse-inspector/#!%28%28exchange:exchange/taskcluster-scheduler/v1/task-graph-running,routingKeyPattern:%23%29%29 <code>exchange/taskcluster-scheduler/v1/task-graph-running</code>]
-;maintainer: jonasfj@mozilla.com
-;description: Notifications of new task-graphs, for details see [http://docs.taskcluster.net/scheduler/events/#taskGraphRunning official documentation]
-=== Scheduler: Task-Graph Extended ===
-;exchange: [https://tools.taskcluster.net/pulse-inspector/#!%28%28exchange:exchange/taskcluster-scheduler/v1/task-graph-extended,routingKeyPattern:%23%29%29 <code>exchange/taskcluster-scheduler/v1/task-graph-extended</code>]
-;maintainer: jonasfj@mozilla.com
-;description: Notifications of task-graph extensions, for details see [http://docs.taskcluster.net/scheduler/events/#taskGraphExtended official documentation]
-=== Scheduler: Task-Graph Blocked ===
-;exchange: [https://tools.taskcluster.net/pulse-inspector/#!%28%28exchange:exchange/taskcluster-scheduler/v1/task-graph-blocked,routingKeyPattern:%23%29%29 <code>exchange/taskcluster-scheduler/v1/task-graph-blocked</code>]
-;maintainer: jonasfj@mozilla.com
-;description: Notifications of blocked task-graphs, for details see [http://docs.taskcluster.net/scheduler/events/#taskGraphBlocked official documentation]
-=== Scheduler: Task-Graph Finished ===
-;exchange: [https://tools.taskcluster.net/pulse-inspector/#!%28%28exchange:exchange/taskcluster-scheduler/v1/task-graph-finished,routingKeyPattern:%23%29%29 <code>exchange/taskcluster-scheduler/v1/task-graph-finished</code>]
-;maintainer: jonasfj@mozilla.com
-;description: Notifications of finished task-graphs, for details see [http://docs.taskcluster.net/scheduler/events/#taskGraphFinished official documentation]
-=== Mozilla: Push detected ===
-;exchange: [https://tools.taskcluster.net/pulse-inspector/#!%28%28exchange:exchange/mozilla-taskcluster/v1/pushlog,routingKeyPattern:%23%29%29 <code>exchange/mozilla-taskcluster/v1/pushlog</code>]
-;maintainer: selena@mozilla.com (for now)
-;description: Notifications of pushes detected by mozilla-taskcluster, still filling in details by reverse engineering
-Generated with [https://github.com/taskcluster/mozilla-taskcluster/blob/master/src/jobs/publish_push.js#L13 publish_push.js]
-=== Taskcluster-treeherder: Job Event ===
+== Firefox Test Engineering ==
-;exchange(prod): [https://tools.taskcluster.net/pulse-inspector/#!%28%28exchange:exchange/taskcluster-treeherder/v1/jobs,routingKeyPattern:%23%29%29 <code>exchange/taskcluster-treeherder/v1/jobs</code>]
+;exchange: [https://tools.taskcluster.net/pulse-inspector?bindings%5B0%5D%5Bexchange%5D=exchange%2Ffxtesteng%2Fjobs&bindings%5B0%5D%5BroutingKeyPattern%5D=%23 <code>exchange/fxtesteng/jobs</code>]
-;exchange(stage): [https://tools.taskcluster.net/pulse-inspector/#!%28%28exchange:exchange/taskcluster-treeherder-staging/v1/jobs,routingKeyPattern:%23%29%29 <code>exchange/taskcluster-treeherder-staging/v1/jobs</code>]
+;maintainer: dhunt@mozilla.com
-;maintainer: garndt@mozilla.com
+;description: Treeherder consumable job information created from automated tests.
-;description: Treeherder consumable job information created from Taskcluster task events.