@@ -9,9 +9,9 @@ import SectionSeparator from "components/MdxSectionSeparator/sectionSeparator.js
9
9
10
10
<SectionSeparator />
11
11
12
- ## Run ADOTCollector Beta on AWS EC2 Linux
12
+ ## Run ADOT Collector on AWS EC2 Linux
13
13
14
- To run ADOTCollector on AWS EC2 Linux host, you can choose to install ADOTCollector RPM on your host by the following steps.
14
+ To run ADOT Collector on AWS EC2 Linux host, you can choose to install ADOT Collector RPM on your host by the following steps.
15
15
16
16
** Steps,**
17
17
@@ -20,51 +20,59 @@ To run ADOTCollector on AWS EC2 Linux host, you can choose to install ADOTCollec
20
20
git clone https://github.com/aws-observability/aws-otel-collector.git
21
21
make package-rpm
22
22
```
23
+
24
+ Alternatively, you can also choose to download the ADOT Collector rpm package directly from S3:
25
+ 1. Login on Amazon Linux 2 EC2 host and download ADOT Collector installation file.
26
+ ```
27
+ wget https://aws-otel-collector.s3.amazonaws.com/amazon_linux/amd64/latest/aws-otel-collector.rpm
28
+ ```
29
+ 2. (Optional) Verify the package integrity.
30
+ ```
31
+ wget https://aws-otel-collector.s3.amazonaws.com/aws-otel-collector.gpg
32
+ sudo rpm --import aws-otel-collector.gpg
33
+ rpm --checksig aws-otel-collector.rpm
34
+ ```
35
+ If the package is verified correctly, you'll see output similar to:
36
+ ```
37
+ aws-otel-collector.rpm: digests signatures OK
38
+ ```
39
+ However, if you see output like:
40
+ ```
41
+ aws-otel-collector.rpm: digests SIGNATURES NOT OK
42
+ ```
43
+ You should stop, and try download the rpm package from the official source again.
44
+
23
45
2 . Install aws-otel-collector RPM by the following command on the host
24
46
```
25
47
sudo rpm -Uvh ./aws-otel-collector.rpm
26
48
```
27
- 3 . Once RPM is installed, it will create ADOTCollector in directory ``` /opt/aws/aws-otel-collector/ ```
49
+ 3 . Once RPM is installed, it will create ADOT Collector in directory ``` /opt/aws/aws-otel-collector/ ```
28
50
29
- 4 . We provided a control script to manage ADOTCollector . Customer can use it to Start, Stop and Check Status of ADOTCollector .
51
+ 4 . We provided a control script to manage ADOT Collector . Customer can use it to Start, Stop and Check Status of ADOT Collector .
30
52
31
- * Start ADOTCollector with CTL script. The config.yaml is optional, if it is not provided the default [ config] ( ../../config.yaml ) will be applied.
53
+ * Start ADOT Collector with CTL script. The config.yaml is optional, if it is not provided the default [ config] ( ../../config.yaml ) will be applied.
32
54
```
33
55
sudo /opt/aws/aws-otel-collector/bin/aws-otel-collector-ctl -c </path/config.yaml> -a start
34
56
```
35
- * Stop the running ADOTCollector when finish the testing.
57
+ * Stop the running ADOT Collector when finish the testing.
36
58
```
37
59
sudo /opt/aws/aws-otel-collector/bin/aws-otel-collector-ctl -a stop
38
60
```
39
- * Check the status of ADOTCollector
61
+ * Check the status of ADOT Collector
40
62
```
41
63
sudo /opt/aws/aws-otel-collector/bin/aws-otel-collector-ctl -a status
42
64
```
43
65
44
- 5 . Test the data with the running ADOTCollector on EC2. you can run the following command on EC2 host. (Docker app has to be pre-installed)
66
+ 5 . Test the data with the running ADOT Collector on EC2. you can run the following command on EC2 host. (Docker app has to be pre-installed)
45
67
```
46
68
docker run --rm -it -e "OTEL_OTLP_ENDPOINT=172.17.0.1:4317" -e "otlp_instance_id=test_insance_rpm" -e "OTEL_RESOURCE_ATTRIBUTES=service.namespace=ADOTCollectorRPMDemo,service.name=ADOTCollectorRPMDemoService" -e S3_REGION=us-west-2 aottestbed/aws-otel-collector-sample-app:java-0.1.0
47
69
```
48
70
49
71
** View Your Metrics**
50
- You should now be able to view your metrics in your [ CloudWatch console] ( https://console.aws.amazon.com/cloudwatch/ ) . In the navigation bar, click on ** Metrics** . The collected ADOTCollector metrics can be found in the ** ADOTCollectorRPMDemo/ADOTCollectorRPMDemoService** namespace.
72
+ You should now be able to view your metrics in your [ CloudWatch console] ( https://console.aws.amazon.com/cloudwatch/ ) . In the navigation bar, click on ** Metrics** . The collected ADOT Collector metrics can be found in the ** ADOTCollectorRPMDemo/ADOTCollectorRPMDemoService** namespace.
51
73
52
- ### Installing ADOTCollector via CloudFormation
53
- ### Install ADOTCollector on ECS EC2
54
- Download CloudFormation template file for installing ADOTCollector on ECS EC2 mode
55
- ```
56
- curl -O https://github.com/mxiamxia/aws-opentelemetry-collector/blob/master/deployment-template/ec2/aws-otel-ec2-deployment-cfn.template
57
- ```
58
- Run CloudFormation the following command once ``` IAMRole ``` , ``` Region ``` , ``` EC2Key ``` and ``` CFN_File_Downloaded ``` are filled.
59
- ```
60
- Region=<aws-region>
61
- IAMRole=<iam-role>
62
- EC2Key=<ec2-ssh-key-name>
63
- aws cloudformation create-stack --stack-name ADOTCollectorEC2-Test \
64
- --template-body file://<CFN_File_Downloaded> \
65
- --parameters ParameterKey=IAMRole,ParameterValue=${IAMRole} \
66
- ParameterKey=KeyName,ParameterValue=${EC2Key} \
67
- --capabilities CAPABILITY_NAMED_IAM \
68
- --region ${Region}
69
- ```
74
+ ### Installing ADOT Collector via CloudFormation
75
+ See [ this section] ( /docs/setup/ec2 ) for detailed information on installing ADOT Collector via CloudFormation on EC2.
70
76
77
+ ### Install ADOT Collector on ECS EC2
78
+ See [ this section] ( /docs/setup/ecs ) for detailed information on installing ADOT Collector on ECS.
0 commit comments