@PLUGIN@ Configuration

Global @PLUGIN@ plugin configuration is stored in the gerrit.config file. An example global @PLUGIN@ configuration section:

[plugin "@PLUGIN@"]
  connectionTimeout = 3000
  socketTimeout = 2500
  maxTries = 300
  retryInterval = 2000
  threadPoolSize = 3

The @PLUGIN@ plugin‘s per project configuration is stored in the @PLUGIN@.config file in project’s refs/meta/config branch. For example, to propagate all events to https://foo.org/gerrit-events and propagate only patchset-created and ref-updated events to https://bar.org/:

[remote "foo"]
  url = https://foo.org/gerrit-events
  maxTries = 3
  sslVerify = true

[remote "bar"]
  url = https://bar.org/
  event = patchset-created
  event = ref-updated

The configuration is inheritable. Connection parameters connectionTimeout, socketTimeout, maxTries, retryInterval and sslVerify can be fine-tuned at remote level.

File ‘gerrit.config’

@PLUGIN@.connectionTimeout : Maximum interval of time in milliseconds the plugin waits for a connection to the target instance. When not specified, the default value is set to 5000ms.

@PLUGIN@.socketTimeout : Maximum interval of time in milliseconds the plugin waits for a response from the target instance once the connection has been established. When not specified, the default value is set to 5000ms.

@PLUGIN@.maxTries : Maximum number of times the plugin should attempt when posting an event to the target url. Setting this value to 0 will disable retries. When not specified, the default value is 5. After this number of failed tries, an error is logged.

@PLUGIN@.retryInterval : The interval of time in milliseconds between the subsequent auto-retries. When not specified, the default value is set to 1000ms.

@PLUGIN@.threadPoolSize : Maximum number of threads used to send events to the target instance. Defaults to 2.

@PLUGIN@.sslVerify : When ‘true’ SSL certificate verification of all webhooks is performed when payload is delivered. Default value is ‘false’.

File ‘@PLUGIN@.config’

remote.NAME.url : Address of the remote server to post events to.

remote.NAME.event : Type of the event which will be posted to the remote url. Multiple event types can be specified, listing event types which should be posted. When no event type is configured, all events will be posted.

remote.NAME.connectionTimeout : Maximum interval of time in milliseconds the plugin waits for a connection to the target instance. When not specified, the default value is derrived from global configuration.

remote.NAME.socketTimeout : Maximum interval of time in milliseconds the plugin waits for a response from the target instance once the connection has been established. When not specified, the default value is derrived from global configuration.

remote.NAME.maxTries : Maximum number of times the plugin should attempt when posting an event to the target url. Setting this value to 0 will disable retries. When not specified, the default value is derrived from global configuration.

remote.NAME.retryInterval : The interval of time in milliseconds between the subsequent auto-retries. When not specified, the default value is derrived from global configuration.

remote.NAME.sslVerify : When ‘true’ SSL certificate verification of remote url is performed when payload is delivered, the default value is derived from global configuration.