Skip to main content
Plan requirement: This feature requires an On-call Standard or higher subscription. Learn more
Use the Apollo Portal release webhook to sync config releases from the Apollo config center to Flashduty On-call. Each release operation (release, rollback, gray release, full release) becomes one Flashduty change, recorded once when Apollo finishes the operation. Apollo sends a webhook only after the operation is done, with no start event. So a change has no Processing state; Flashduty records its final state directly (Done, or Canceled for an abandoned release). A change here is a configuration change, not a deployment of an application.
The Apollo payload contains the full configuration after the release (keys and values), which can include passwords and tokens. Flashduty does not read or store it: a change has no config key or value.

In Flashduty On-call

  1. In the Flashduty console, go to Integration Center → Change Events
  2. Select Apollo and enter an integration name
  3. To assign changes to specific channels, add rules under the integration’s Routes that match labels such as app_id, environment, or namespace
  4. Click Save and copy the generated Push URL

Configure Apollo

Apollo supports the config release webhook since version 1.8.0. The settings live in the ApolloPortalDB.ServerConfig table. You can also edit them on the Apollo Portal page Administrator Tools → System Parameters; a change takes effect in about a minute.
1

Choose the environments to push

Add or edit the setting webhook.supported.envs. The value is the list of environments that send the webhook, separated by commas:
Use the environment names shown in your Portal. For example, the environment of the quick-start (all-in-one) image is LOCAL.
2

Set the push URL

Add or edit the setting config.release.webhook.service.url and set it to the Flashduty Push URL:
Paste the Push URL exactly as Flashduty shows it. The integration key is in the path, not in an ?integration_key= query parameter, because Apollo appends ?env=<environment> to the configured URL. If the URL already had a query string, the integration key would be corrupted and the request would fail authentication.Flashduty reads the environment from the env parameter, so do not add query parameters to the URL yourself.
3

Verify

Apollo has no test delivery: publish a config in any environment that has the webhook enabled, and the change appears in the Flashduty change list.

How changes are merged

One change is one Apollo release operation.
  • Two releases of the same namespace are two changes, and so are a release and a later rollback; a rollback is not merged into the original release record
  • Releases in different environments are never merged

Status mapping

The operation Apollo sends decides the kind of change; the status is Done, except for abandoned releases (see the note below the table): When isReleaseAbandoned in the payload is true (the release the delivery describes has been abandoned), the change status is Canceled. Any operation value other than the four above returns InvalidParameter and creates no change.

Change content

The title verbs are fixed Chinese words (发布 release, 回滚到 roll back to, 灰度发布 gray release, 全量发布 full release); filter on the operation label rather than on the title. Use labels for routing and for filtering the change list:

FAQ

The Apollo payload carries the full configuration after the release, which can include passwords and tokens. Flashduty does not parse it, so a change contains no config key or value. To see what changed, open the release history in the Apollo Portal.
No. Apollo sends the webhook only when a normal release, rollback, gray release, or full release completes. Changing the gray rules does not send one.
No. Apollo sends each release to each URL once and only logs an error in the Portal log when it fails. A lost delivery means the release does not appear in Flashduty.
  • env is missing: the request has no env parameter. Check that the value of config.release.webhook.service.url is the Push URL Flashduty shows, with no query parameters added
  • Other … is missing, unknown operation, or invalid releaseTime: the payload is incomplete. Confirm it comes from the Apollo Portal release webhook and that operation is one of 0, 1, 2, 4
Apollo does not show the response. Look for Notify webHook server failed in the Portal log for failures.
Yes. Releases in different environments are separate changes. To send environments to different channels, add route rules on the environment label of the integration.