From a3510c05daac14ee4fae8fcea9abd699d3c25f9c Mon Sep 17 00:00:00 2001 From: Vijay N Date: Sat, 24 Feb 2024 16:32:22 +0530 Subject: [PATCH 1/4] Added steps to install xray daemon on standalone EC2. --- userguide/tutorials/metrics-cloudwatch.adoc | 20 ++++++++++++++++---- 1 file changed, 16 insertions(+), 4 deletions(-) diff --git a/userguide/tutorials/metrics-cloudwatch.adoc b/userguide/tutorials/metrics-cloudwatch.adoc index 9a9659171..1f3829774 100644 --- a/userguide/tutorials/metrics-cloudwatch.adoc +++ b/userguide/tutorials/metrics-cloudwatch.adoc @@ -39,14 +39,14 @@ KillBill web applications. This is a small file. The line to be edited is: ``` --Dcom.killbill.cloudwatch.enable=false +-Dcom.killbill.aws.enableCloudWatchMetrics=false ``` This should be changed to: ``` --Dcom.killbill.cloudwatch.enable=true +-Dcom.killbill.aws.enableCloudWatchMetrics=true ``` After editing the file, go to your AWS EC2 dashboard and *reboot the @@ -60,8 +60,20 @@ AWS X-Ray is a service that collects and analyzes data from your applications. A To setup the daemon, log in to your EC2 instance and run the following commands: ``` -curl https://s3.dualstack.us-east-1.amazonaws.com/aws-xray-assets.us-east-1/xray-daemon/aws-xray-daemon-3.x.deb -o /home/ubuntu/xray.deb -sudo dpkg -i /home/ubuntu/xray.deb +# Download the X-Ray daemon package +wget https://s3.us-east-2.amazonaws.com/aws-xray-assets.us-east-2/xray-daemon/aws-xray-daemon-3.x.deb + +# Install the package using dpkg +sudo dpkg -i aws-xray-daemon-3.x.deb + +# Install any dependencies or fix broken dependencies (if needed) +sudo apt-get install -f + +# Enable X-Ray as a system service to start on boot +sudo systemctl enable xray + +# Start the X-Ray service +sudo systemctl start xray ``` If you have more than one instance, repeat these commands on each one. From ef502e1c08c2480d1823dec657a7f895bf113a70 Mon Sep 17 00:00:00 2001 From: Vijay N Date: Tue, 23 Apr 2024 18:55:52 +0530 Subject: [PATCH 2/4] * XRay daemon now comes preinstalled with AMI. Removed the installation step. --- userguide/tutorials/metrics-cloudwatch.adoc | 24 --------------------- 1 file changed, 24 deletions(-) diff --git a/userguide/tutorials/metrics-cloudwatch.adoc b/userguide/tutorials/metrics-cloudwatch.adoc index 1f3829774..6754eb762 100644 --- a/userguide/tutorials/metrics-cloudwatch.adoc +++ b/userguide/tutorials/metrics-cloudwatch.adoc @@ -53,30 +53,6 @@ After editing the file, go to your AWS EC2 dashboard and *reboot the instance* so the new configuration file will be read. If you have more than one instance, follow the same procedure for each one. -== Install the X-Ray daemon - -AWS X-Ray is a service that collects and analyzes data from your applications. A daemon is a process that runs in the background to do a job whenever it is needed. The X-Ray daemon uploads application metrics to X-Ray in batches to be processed. X-Ray then forwards this data to CloudWatch for display. - -To setup the daemon, log in to your EC2 instance and run the following commands: - -``` -# Download the X-Ray daemon package -wget https://s3.us-east-2.amazonaws.com/aws-xray-assets.us-east-2/xray-daemon/aws-xray-daemon-3.x.deb - -# Install the package using dpkg -sudo dpkg -i aws-xray-daemon-3.x.deb - -# Install any dependencies or fix broken dependencies (if needed) -sudo apt-get install -f - -# Enable X-Ray as a system service to start on boot -sudo systemctl enable xray - -# Start the X-Ray service -sudo systemctl start xray -``` - -If you have more than one instance, repeat these commands on each one. == Create an IAM Policy From b378c29863bd8800ad11f89b7d3cc4aabf42e388 Mon Sep 17 00:00:00 2001 From: Vijay N Date: Mon, 6 May 2024 10:07:21 +0530 Subject: [PATCH 3/4] * Corrected the CF product ID. --- userguide/tutorials/aws-cf.adoc | 2 +- userguide/tutorials/aws.adoc | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/userguide/tutorials/aws-cf.adoc b/userguide/tutorials/aws-cf.adoc index bfe47d6ad..07fd867bc 100644 --- a/userguide/tutorials/aws-cf.adoc +++ b/userguide/tutorials/aws-cf.adoc @@ -68,7 +68,7 @@ To create a key pair, from the EC2 console scroll down to *Networks & Security / === Configure and Launch -The setup process starts at the AWS Marketplace using our +++official CloudFormation template.+++ Go to this page, then click *Continue to Subscribe*. +The setup process starts at the AWS Marketplace using our +++official CloudFormation template.+++ Go to this page, then click *Continue to Subscribe*. image::../assets/aws/cf-subscribe.png[align=center] diff --git a/userguide/tutorials/aws.adoc b/userguide/tutorials/aws.adoc index f6716c2fb..759232152 100644 --- a/userguide/tutorials/aws.adoc +++ b/userguide/tutorials/aws.adoc @@ -16,7 +16,7 @@
Multi-Tier CloudFormation with Amazon Aurora

Production ready setup in minutes (most popular)

- Launch + Launch

Docs

From 42969295b54661c195c7d12d83bdfabdbaca3d20 Mon Sep 17 00:00:00 2001 From: Vijay N Date: Mon, 6 May 2024 10:15:06 +0530 Subject: [PATCH 4/4] * Changes in metrics-cloudwatch.adoc are not relevant to this PR. --- userguide/tutorials/metrics-cloudwatch.adoc | 16 ++++++++++++++-- 1 file changed, 14 insertions(+), 2 deletions(-) diff --git a/userguide/tutorials/metrics-cloudwatch.adoc b/userguide/tutorials/metrics-cloudwatch.adoc index 6754eb762..9a9659171 100644 --- a/userguide/tutorials/metrics-cloudwatch.adoc +++ b/userguide/tutorials/metrics-cloudwatch.adoc @@ -39,20 +39,32 @@ KillBill web applications. This is a small file. The line to be edited is: ``` --Dcom.killbill.aws.enableCloudWatchMetrics=false +-Dcom.killbill.cloudwatch.enable=false ``` This should be changed to: ``` --Dcom.killbill.aws.enableCloudWatchMetrics=true +-Dcom.killbill.cloudwatch.enable=true ``` After editing the file, go to your AWS EC2 dashboard and *reboot the instance* so the new configuration file will be read. If you have more than one instance, follow the same procedure for each one. +== Install the X-Ray daemon + +AWS X-Ray is a service that collects and analyzes data from your applications. A daemon is a process that runs in the background to do a job whenever it is needed. The X-Ray daemon uploads application metrics to X-Ray in batches to be processed. X-Ray then forwards this data to CloudWatch for display. + +To setup the daemon, log in to your EC2 instance and run the following commands: + +``` +curl https://s3.dualstack.us-east-1.amazonaws.com/aws-xray-assets.us-east-1/xray-daemon/aws-xray-daemon-3.x.deb -o /home/ubuntu/xray.deb +sudo dpkg -i /home/ubuntu/xray.deb +``` + +If you have more than one instance, repeat these commands on each one. == Create an IAM Policy