From 67f2d4758850a335422b63cd5af90dfb5f368233 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Heitor=20Jos=C3=A9=20Tessaro?= Date: Wed, 24 Jul 2024 16:18:53 -0300 Subject: [PATCH] docs: updates the event rate docs --- .../auto-operation/event-rate.mdx | 41 ++++++++++++++---- .../event-rate-condition-panel.png | Bin 0 -> 17338 bytes .../event-rate-condition-v4.png | Bin 0 -> 18751 bytes 3 files changed, 33 insertions(+), 8 deletions(-) create mode 100644 static/img/feature-flags/auto-ops-rules/event-rate-condition-panel.png create mode 100644 static/img/feature-flags/auto-ops-rules/event-rate-condition-v4.png diff --git a/docs/feature-flags/creating-feature-flags/auto-operation/event-rate.mdx b/docs/feature-flags/creating-feature-flags/auto-operation/event-rate.mdx index 23d7d0b..daf45fa 100644 --- a/docs/feature-flags/creating-feature-flags/auto-operation/event-rate.mdx +++ b/docs/feature-flags/creating-feature-flags/auto-operation/event-rate.mdx @@ -38,18 +38,43 @@ Refer to the [Experiments](/feature-flags/testing-with-flags/experiments) and [E To add an event rate condition to a feature flag, you need to follow the steps below: -1. Go to the **Auto Operation** page. -2. Click the **+ Add** button. -3. The operation setting panel will appear. Choose the **Kill Switch** option. -4. Select **Event Rate**. -5. Set up the conditions. Define the variation, goal, condition, threshold, and minimum count. -6. Click **Submit**. +1. Go to the **Auto Operation** tab on the feature Flag page details. +2. Click the **+ New Operation** and select **Event Rate**. +3. Set up the conditions. Define the variation, goal, condition, threshold, and minimum count. +4. Click **Submit**. The image below presents an example of event rate configuration. The current configuration's objective is to turn off the feature flag in case of a high error rate above 5%. A minimum count of 500 is used to avoid misleading turn-offs. \ No newline at end of file +/> + +## Managing event rates + +After creating an event rate, it becomes active and is available in the Auto Operation panel. You can identify it by the **Event Rate** tag or the **Kill Switch Operation** type. The event rate progress information visually displays the current event rate percentage and includes: + +- The associated goal. +- The minimum goal count. +- The total goal count events. +- The current event rate value. + +The following image shows an example of progress information for a running event rate: + + + +While active, you can edit, stop, or delete the event rate: + +- **Edit Kill Switch**: Allows you to change the variation, goal, condition, threshold, and minimum count associated with the event rate. +- **Stop Kill Switch**: Stops the event rate and moves it to the Finished tab. +- **Delete Kill Switch**: Stops and removes the event rate information from the server. Use this option carefully. Only logs related to that event rate will be reported on the Audit Logs page. + +## Event rate lifecycle + +When you create an event rate, it will be active and available in the **Active** tab of the Auto Operation panel. The event rate (kill switch operation) continuously monitors the flag operation, counting every condition defined at its creation. When the threshold is reached, it will kill the flag, turning it off. Afterward, the event rate moves to the **Finished** tab. \ No newline at end of file diff --git a/static/img/feature-flags/auto-ops-rules/event-rate-condition-panel.png b/static/img/feature-flags/auto-ops-rules/event-rate-condition-panel.png new file mode 100644 index 0000000000000000000000000000000000000000..1681019e510b843d6318e6034a3ccef267e5bb43 GIT binary patch literal 17338 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