https://github.com/youyo/zaia
ec2-instance golang zabbix zabbix-aws
Last synced: about 1 year ago
JSON representation
- Host: GitHub
- URL: https://github.com/youyo/zaia
- Owner: youyo
- License: mit
- Created: 2018-04-12T07:41:39.000Z (about 8 years ago)
- Default Branch: master
- Last Pushed: 2021-02-19T06:29:42.000Z (over 5 years ago)
- Last Synced: 2024-05-01T14:24:07.314Z (about 2 years ago)
- Topics: ec2-instance, golang, zabbix, zabbix-aws
- Language: Go
- Size: 48.8 KB
- Stars: 1
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# zabbix-aws-integration-agent
Used by Zabbix LLD.
It performs authentication by Assume role.
The role of zabbix-aws-integration-agent.
```
{
"Version": "2012-10-17",
"Statement": [
{
"Action": [
"sts:AssumeRole"
],
"Resource": "*",
"Effect": "Allow"
}
]
}
```
The side to be integrated has a ReadOnlyAccess by aws maneged policy.
Trust Relationship policy.
```
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Principal": {
"AWS": "arn:aws:iam::00000000:root"
},
"Action": "sts:AssumeRole",
"Condition": {}
}
]
}
```
## Usage
### Start process
zabbix-aws-integration-agent is running in docker container.
https://hub.docker.com/r/youyo/zabbix-aws-integration-agent/
```
$ docker container run -d -p 10050:10050 -e AWS_ACCESS_KEY_ID=your_aws_access_key -e AWS_SECRET_ACCESS_KEY=your_aws_secret_access_key --restart always --name zabbix-aws-integration-agent youyo/zabbix-aws-integration-agent:latest
```
### Request method
Request method is zabbix protocol.
- Discovery of running EC2 instances.
Syntax
```
$ zabbix_get -s zabbix-aws-integration-agent-host -k aws-integration.ec2.discovery[Zabbix-host-group,ARN,Region]
```
Example
```
$ zabbix_get -s 127.0.0.1 -k aws-integration.ec2.discovery[zabbix-host-group,arn:aws:iam::00000000:role/rolename,ap-northeast-1]
{
"data": [
{
"{#INSTANCE_ID}": "i-0000xxxx",
"{#INSTANCE_NAME}": "Name tag of the instance",
"{#INSTANCE_ROLE}": "Role tag of the instance",
"{#ZABBIX_HOST_GROUP}": "zabbix-host-group"
}
]
}
```
- Whether the ec2 instance has maintenance
Syntax
```
$ zabbix_get -s zabbix-aws-integration-agent-host -k aws-integration.ec2.maintenance[Instance-id,No maintenance message,ARN,Region]
```
Example
```
$ zabbix_get -s 127.0.0.1 -k aws-integration.ec2.maintenance[i-0000xxxx,No maintenance,arn:aws:iam::00000000:role/rolename,ap-northeast-1]
No maintenance
```
- Discovery of RDS instances.
Syntax
```
$ zabbix_get -s zabbix-aws-integration-agent-host -k aws-integration.rds.instance.discovery[Zabbix-host-group,ARN,Region]
```
Example
```
$ zabbix_get -s 127.0.0.1 -k aws-integration.rds.instance.discovery[zabbix-host-group,arn:aws:iam::00000000:role/rolename,ap-northeast-1]
{
"data": [
{
"{#DB_INSTANCE_IDENTIFIER}": "identifier",
"{#ENGINE}": "aurora-mysql",
"{#ZABBIX_HOST_GROUP}": "zabbix-host-group"
}
]
}
```
- Whether the rds instance has maintenance
Syntax
```
$ zabbix_get -s zabbix-aws-integration-agent-host -k aws-integration.rds.instance.maintenance[db-instance-identifier,No maintenance message,ARN,Region]
```
Example
```
$ zabbix_get -s 127.0.0.1 -k aws-integration.rds.instance.maintenance[db-instance-identifier,No maintenance,arn:aws:iam::00000000:role/rolename,ap-northeast-1]
No maintenance
```
- Discovery of RDS clusters
Syntax
```
$ zabbix_get -s zabbix-aws-integration-agent-host -k aws-integration.rds.cluster.discovery[Zabbix-host-group,ARN,Region]
```
Example
```
$ zabbix_get -s 127.0.0.1 -k aws-integration.rds.cluster.discovery[zabbix-host-group,arn:aws:iam::00000000:role/rolename,ap-northeast-1]
{
"data": [
{
"{#DB_CLUSTER_IDENTIFIER}": "identifier",
"{#ENGINE}": "aurora-mysql",
"{#ZABBIX_HOST_GROUP}": "zabbix-host-group"
}
]
}
```
- Whether the rds cluster has maintenance
Syntax
```
$ zabbix_get -s zabbix-aws-integration-agent-host -k aws-integration.rds.cluster.maintenance[db-cluster-identifier,No maintenance message,ARN,Region]
```
Example
```
$ zabbix_get -s 127.0.0.1 -k aws-integration.rds.cluster.maintenance[db-cluster-identifier,No maintenance,arn:aws:iam::00000000:role/rolename,ap-northeast-1]
No maintenance
```
- Fetch CloudWatch data
Syntax
```
$ zabbix_get -s zabbix-aws-integration-agent-host -k aws-integration.cloudwatch.get-metrics[Namespace,Dimension-name,Dimension-value,Metrics,Statistic,ARN,Region]
```
Example
```
$ zabbix_get -s 127.0.0.1 -k aws-integration.cloudwatch.get-metrics[AWS/EC2,InstanceId,i-0000xxxx,CPUUtilization,Average,arn:aws:iam::00000000:role/rolename,ap-northeast-1]
7.696
```