Send Visit Events From Your WordPress VIP Website

Are You Using Regular WordPress?

If your website is not hosted on WordPress VIP, use the WordPress plugin integration instead.

Step 1: Configure Log Shipping

Known Agents can read logs from an Amazon S3 bucket that you're already using, or create and manage a Google Cloud bucket on your behalf. If your environment is already shipping logs to a destination other than Amazon S3, please contact us.

Option 1: Use an Existing Amazon S3 Bucket

Open your AWS dashboard
In the search bar at the top of the screen, type in and select Amazon S3
Select the bucket
Open the Permissions tab
Under Bucket policy, click Edit

Add the following Known Agents AWS account ARN to the Principal.AWS allow list in the bucket's existing policy.

arn:aws:iam::632783683978:root

If the policy does not already contain a compatible allow list, add the following statement and replace YOUR-BUCKET-NAME with the bucket name.

{
    "Sid": "AllowKnownAgentsAccountAccess",
    "Effect": "Allow",
    "Principal": {
        "AWS": "arn:aws:iam::632783683978:root"
    },
    "Action": [
        "s3:GetObject",
        "s3:ListBucket"
    ],
    "Resource": [
        "arn:aws:s3:::YOUR-BUCKET-NAME",
        "arn:aws:s3:::YOUR-BUCKET-NAME/*"
    ]
}

Save the bucket policy changes.

Navigate to the Known Agents Projects page, open your project, and click Settings
Scroll to Integrations
Under WordPress VIP Log Shipping and Existing Amazon S3 Bucket, enter the bucket name and optional S3 prefix
Click Save

Option 2: Use a Managed Google Cloud Bucket

Navigate to the Known Agents Projects page, open your project, and click Settings
Scroll to Integrations
Under WordPress VIP Log Shipping and Managed Google Cloud Bucket, click Enable
Open your application in the WordPress VIP Dashboard
Select the environment that should send logs
Click Logs in the sidebar, then Log Shipping
Select HTTP request edge logs under Shipping Contents, then click Continue
Select Google Cloud Storage, then click Continue
Copy the GCP Bucket Name, GCP Prefix, and GCP Credentials JSON values from Known Agents Project Settings into the matching fields
Click Run Test
After the test succeeds, click Enable in the Log Shipping panel

Step 2: Test Your Integration

Return to your Known Agents project
Click Settings
Click Send a Test Visit
Click Realtime

WordPress VIP ships logs in large batches, so the test visit can take up to 5 minutes to appear in the realtime timeline.