appmesh-logs-collector's Introduction

App Mesh Logs Collector

The project was created in order to retrieve logs from your AWS App Mesh resources for troubleshooting purpose.

Prerequisites

Make sure to have the latest version of AWS CLI installed and configured with credentials that contain IAM App Mesh permissions.
Make sure to have jq installed.
(Kubernetes only) Make sure to have kubectl installed, at least version 1.11 or above. Set the correct context for your Kubernetes cluster.

Setup

Download the App Mesh Logs Collector script by running the following command:

curl -O https://raw.githubusercontent.com/leandrocostam/appmesh-logs-collector/master/appmesh-logs-collector.sh

Collect App Mesh Resources

Collect information of your AWS App Mesh (mesh, virtual services, virtual nodes, etc) by running the following command:

sudo bash appmesh-logs-collector.sh --resource appmesh --mesh-name <mesh-name> --region <aws-region>

Collect Related Resources in Amazon EKS / Kubernetes

Collect logs and settings from envoy containers running on Kubernetes cluster per namespace by running the following command:

sudo bash appmesh-logs-collector.sh --resource k8s --namespace <namespace>

Collect Related Resources in Amazon EC2 (not ready)

Collect all information of your App Mesh resources running in your Amazon EC2 by running the following command from the EC2 instance:

$ sudo bash appmesh-logs-collector.sh --resource ec2

Script Options

$ sudo bash appmesh-logs-collector.sh --help
usage: appmesh-logs-collector.sh [options]

-h,--help print this help
--resource (appmesh|k8s|ec2)
--resource "appmesh" --mesh-name <name-mesh> --region <aws-region>
--resource "k8s" --namespace <namespace>
--resource "ec2"

Default values:
region: us-east-1
namespace: default

Contribuite

Please, feel free to place a pull request whether something is not up-to-date, should be added, fixed, or contains wrong information/reference.

Recommend Projects

henriquesantanati / appmesh-logs-collector Goto Github PK