-
Notifications
You must be signed in to change notification settings - Fork 10k
[Logs] Dedicated Egress for IP #24628
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Merged
Merged
Changes from 3 commits
Commits
Show all changes
6 commits
Select commit
Hold shift + click to select a range
4d84888
Dedicated Egress for IP
angelampcosta 64a4305
Adds space
angelampcosta e8fa66c
Correct title
angelampcosta e829d4b
Apply suggestions from code review
angelampcosta c90bc6b
Adds links
angelampcosta 7a65ac0
Add bold
angelampcosta File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
59 changes: 59 additions & 0 deletions
59
src/content/docs/logs/logpush/logpush-job/enable-destinations/egress-ip.mdx
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,59 @@ | ||
| --- | ||
| title: Dedicated Egress IP for Logpush | ||
| pcx_content_type: how-to | ||
| sidebar: | ||
| order: 101 | ||
| head: | ||
| - tag: title | ||
| content: Dedicated Egress IP for Logpush | ||
| --- | ||
|
|
||
| This guide covers [Aegis](/aegis/) and Logpush configuration and testing instructions to enable log delivery with a fixed, dedicated egress IP. | ||
|
|
||
| ## Prerequisites | ||
|
|
||
| To use Logpush with a dedicated egress IP, you will need to have Aegis IPs. Note that the Aegis IP pool is associated with a zone, not with an account. In order to use Logpush with dedicated IPs, traffic must be routed to a single zone. | ||
|
|
||
| The general approach is to have your logpush job proxy logpush data through a Cloudflare zone with Aegis enabled to send data to your desired destination. This way your destination will only need to whitelist the provisioned Aegis IPs of your proxy zone. | ||
angelampcosta marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
|
||
|
|
||
| As a prerequisite, you need to create a dedicated zone or use an existing zone. If using an existing zone, be aware that the zone's egress will be restricted to Aegis IPs. Make sure all services using that zone will not be impacted. | ||
|
|
||
| It is recommended to use a separate, dedicated zone as a proxy to avoid impacting production systems. If you choose to create a new zone, follow the steps to register a new domain with Cloudflare. | ||
angelampcosta marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
|
||
|
|
||
| The following example shows how to set up logpush and Aegis to proxy an https destination, but the proxying should work for any supported logpush destination as all destinations use the http protocol underneath. | ||
angelampcosta marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
|
||
|
|
||
| ## 1. Provision Aegis IP Pool | ||
|
|
||
| 1. Work with your Cloudflare account team to purchase [Aegis](/aegis/) IPs for your zone. | ||
|
|
||
| 2. (Optional but recommended) Request two IPs — one in PDX-B and one in SJC-A — to ensure coverage across regions. | ||
|
|
||
| 3. Confirm Pool ID once provisioned. | ||
|
|
||
| ## 2. Configure a zone for Aegis | ||
|
|
||
| 1. Register or use an existing zone for the Aegis pool. | ||
|
|
||
| 2. Associate the Pool ID with the selected zone using the API. For more details, refer to the [Aegis Setup documentation](/aegis/setup/). | ||
|
|
||
| ## 3. Proxy zone setup | ||
|
|
||
| 1. In your zone, add a DNS record (CNAME or A/AAAA) with Target as HTTP destination endpoint. | ||
|
|
||
|  | ||
angelampcosta marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
|
||
|
|
||
| 2. If needed, configure [origin rules](/rules/origin-rules/) to specify a custom port. This is useful if your destination only accepts traffic on a non standard port, for example `12345`. You can configure `logpush.yourdestinationendpoint`.com (without specifying a port, as Cloudflare by default only proxies traffic on http/https ports) to proxy to `yourdestinationendpoint.com:12345`. | ||
angelampcosta marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
|
||
|
|
||
|
|
||
| ## 4. Configure Logpush | ||
|
|
||
| 1. Create a Logpush job with the following details: | ||
|
|
||
| - Destination: HTTP | ||
| - Endpoint: Use the domain/path set up (Logpush UI will auto-validate the destination). Use the server Name specified in the Name section in the DNS record. In this case, `logpush.yourdestionationendpoint.com`. | ||
angelampcosta marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
|
||
|
|
||
|  | ||
angelampcosta marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
|
||
|
|
||
| - Configuration: Select dataset, job name, filters, and fields. Refer to the Logpush documentation for more details. | ||
angelampcosta marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
|
||
|
|
||
| 2. Check destination to confirm if the logs are received. | ||
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Uh oh!
There was an error while loading. Please reload this page.