alpine/awslogs

Alpine/awslogs Docker镜像文档

镜像概述

本镜像基于Alpine Linux构建，集成了awslogs和saw两款工具，旨在为开发和运维人员提供便捷的AWS CloudWatch日志管理解决方案。无需在本地系统安装依赖，通过容器即可快速访问和操作AWS CloudWatch日志。

核心功能与特性

包含工具

• awslogs：AWS CloudWatch Logs官方命令行工具，支持查询日志组、查看日志事件、导出日志等操作（https://github.com/jorgebastida/awslogs%EF%BC%89
• saw：交互式AWS CloudWatch Logs查看工具，提供实时日志监控、关键词搜索等增强功能（https://github.com/TylerBrock/saw%EF%BC%89

核心优势

• 轻量级：基于Alpine Linux，镜像体积小，启动速度快
• 无依赖：容器化封装，避免本地环境配置冲突
• 功能全面：同时支持基础日志管理和实时监控需求

使用场景

• 开发人员调试AWS服务时实时查看应用日志
• 运维人员快速检索历史日志事件进行问题排查
• 需要临时访问AWS CloudWatch日志的环境（如临时工作站、CI/CD节点）

使用方法与配置说明

前置条件

• 本地已安装Docker引擎
• 拥有有效的AWS访问凭证（通常存储在~/.aws/credentials和~/.aws/config文件中）

基本使用步骤

1. 启动容器

通过挂载本地AWS配置目录，使容器获得AWS访问权限：

bash
docker run -ti --rm -v ${HOME}/.aws:/root/.aws docker.xuanyuan.run/alpine/awslogs bash

• -ti：交互式终端模式
• --rm：容器退出后自动删除
• -v ${HOME}/.aws:/root/.aws：挂载本地AWS配置目录到容器内

2. 配置环境变量

进入容器后，需设置AWS区域（必填），如使用非默认AWS配置文件需额外设置配置文件名称：

bash
# 设置AWS区域（示例为us-east-1，根据实际需求修改）
export AWS_REGION=us-east-1

# （可选）如使用非默认配置文件，设置配置文件名称
export AWS_PROFILE=<your-profile-name>

工具使用示例

使用awslogs管理日志

bash
# 列出所有日志组
awslogs groups

# 查看指定日志组的日志流
awslogs streams /aws/lambda/my-function

# 查看最近1小时的日志事件
awslogs get /aws/lambda/my-function ALL --start='1h ago'

使用saw实时监控日志

bash
# 实时监控指定日志组（替换LOG_GROUP为实际日志组名称）
saw watch LOG_GROUP

# 监控日志时过滤包含"error"的日志行
saw watch LOG_GROUP --filter error

# 查看指定时间范围内的日志（如过去30分钟）
saw get LOG_GROUP --start '30m ago'

环境变量说明