Gaia - AWS log finder¶

Version 2.0.0.

Config¶

gaia_conf.json¶

./gaia_conf.json 파일은 S3 Bucket Path를 저장하는데 사용됩니다. json 형태의 key, value 값을 통해서 관리되는데 저장되는 값은 Bucket Path를 가리키는 Key값과 해당 Path의 값을 포함합니다.

gaia_conf.json파일은

{
  "BUCKET_PATH":{
    "key1" : "S3/path/<YY>/<MM>/<DD>/<HH>/<MI>/<SC>",
    "key2" : "S32/path2"
  }
}

처럼 사용합니다.

gaia에서 key값은 실제 s3 Bucket을 찾아가는데 어떠한 영향도 미치지 않기 때문에 명명에 자유롭습니다. 또한 gaia는 S3 Bucket Path가 날짜 단위로 나뉘어져 있는 경우에도 문제 없이 대응합니다. 예를 들어 실제 경로가 log/path/<년>/<월>/<일>/ 로 날짜마다 가변적으로 대응되어야 한다면 위의 예시와 같이 <> 를 사용하여 대응할 수 있습니다.

Command¶

gen¶

$ gaia gen
$ gaia gen -k key -p value

gen 명령어는 2가지 역할을 합니다.

첫째로, gaia_conf.json 이 존재하지 않을 경우 이를 생성합니다.
둘째로, path 값을 추가할 수 있습니다.

물론 gen 명령어는 둘 중의 한가지 기능만 필요할 경우에도 지원합니다.

find¶

$ gaia find key keyword
$ gaia gen key -t [UTC-time] keyword

gaia_conf.json 파일에서 지정된 설정 값을 이용해서 로그를 검색하는 명령어 입니다. key와 keyword를 argument 로 time을 option 으로 받은 후 명령어를 실행합니다. time value는 iso 8601 표준을 따르는 UTC 변수만을 지원합니다. 해당 변수는 Bucket Path에 존재하는 날짜 경로에 대응하기 위해 이용되며, 자릿값을 맞추기 위해 한 자릿수 일 경우 앞에 0을 붙여 표현합니다.

keyword에 매치되는 로그가 있다면 해당 로그를 반환하지만 없다면 keyword does not exist 를 반환합니다.