Skip to content

docs: edge proxy health check configuration#4580

Merged
matthewelwell merged 6 commits intomainfrom
docs/edge-proxy-health-check-configuration
Sep 4, 2024
Merged

docs: edge proxy health check configuration#4580
matthewelwell merged 6 commits intomainfrom
docs/edge-proxy-health-check-configuration

Conversation

@matthewelwell
Copy link
Copy Markdown
Contributor

Changes

The main purpose of this PR is to add the corresponding documentation for this edge proxy PR.

I have also slightly tweaked the formatting of the documentation (although it could still use some finessing at some point).

How did you test this code?

Ran the docs locally and verified the changes.

@matthewelwell matthewelwell requested a review from a team as a code owner September 4, 2024 11:35
@matthewelwell matthewelwell requested review from agregoryfs and removed request for a team September 4, 2024 11:35
@vercel
Copy link
Copy Markdown

vercel bot commented Sep 4, 2024

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name Status Preview Comments Updated (UTC)
docs ✅ Ready (Inspect) Visit Preview 💬 Add feedback Sep 4, 2024 7:16pm
2 Skipped Deployments
Name Status Preview Comments Updated (UTC)
flagsmith-frontend-preview ⬜️ Ignored (Inspect) Visit Preview Sep 4, 2024 7:16pm
flagsmith-frontend-staging ⬜️ Ignored (Inspect) Visit Preview Sep 4, 2024 7:16pm

@matthewelwell matthewelwell requested review from rolodato and removed request for agregoryfs September 4, 2024 11:35
@github-actions github-actions bot added the docs Documentation updates label Sep 4, 2024
Comment on lines +247 to +248
"count_stale_documents_as_failing": true,
"grace_period_seconds": 30
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Are these the new defaults? Looking at https://github.com/Flagsmith/edge-proxy/pull/122/files#diff-4573c040951bc5c2676139dcf260c4a96b0f9b830f15227322c0a1f8545da004R104-R105

In which case these docs should mention how to change the defaults, only if needed

### `config.json` example
### Health Check

The health check can be configured depending on the use case for the Edge Proxy by adding the `health_check` object to
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggest using active voice instead of passive voice https://developers.google.com/style/voice, and clarifying what the default behaviour is. Something like this:

The Edge Proxy exposes a health check endpoint at `/proxy/health` that responds with a 200 status code if was able to fetch all its configured environment documents. If any environment document could not be fetched during the latest poll, it will respond with a 500 status code.

In some cases, you may want the Edge Proxy to succeed its health checks even if it failed to fetch any environment document, but only if it these documents were successfully fetched at some point in the past. You can achieve this by...

(I was typing this suggestion until I saw this: https://github.com/Flagsmith/flagsmith/pull/4580/files#r1743739010 - this would need to be changed depending on what the new defaults are)

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Good feedback, thanks. I've updated the PR with changes that (I think) resolve both of your comments.

@matthewelwell matthewelwell added this pull request to the merge queue Sep 4, 2024
Merged via the queue into main with commit e66b0b5 Sep 4, 2024
@matthewelwell matthewelwell deleted the docs/edge-proxy-health-check-configuration branch September 4, 2024 19:53
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

docs Documentation updates

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants