安装代理

Stackdriver Logging 代理可将日志从虚拟机实例和选定的第三方软件包流式传输到 Stackdriver Logging。最好在所有虚拟机实例上都运行 Stackdriver Logging 代理。

Compute Engine 和 AWS EC2 的虚拟机映像不包含 Logging 代理,因此您必须在这些实例上安装该代理。该代理可在 Linux 和 Windows 上运行。

准备工作

检查 Stackdriver Logging 代理是否支持您的虚拟机实例,并了解工作区。如需详细了解相关要求和支持的环境,请参阅关于 Stackdriver Logging 代理

支持的虚拟机实例

某些类型的虚拟机实例已包含 Logging 代理或与 Logging 代理类似的软件。对于其他虚拟机实例,您应该按照此页面上的说明安装该代理:

  • Google Cloud Platform (GCP) 虚拟机实例:
    • App Engine:代理包含在虚拟机映像中。跳过此页面。
    • GKE:代理包含在虚拟机映像中。跳过此页面。
    • Compute Engine:在虚拟机实例上安装代理。虚拟机实例已拥有所需授权。请参阅在 Linux 和 Windows 上安装
  • Amazon EC2:在安装代理之前,必须在虚拟机实例上安装授权凭据。安装好这些凭据后,请返回此文档以完成在 Linux 和 Windows 上安装步骤。

安装 Stackdriver Logging 代理时,至少需要 250 MB 的内存,但建议留出 1 GB 可用内存。

Stackdriver 结算

如果您使用的是 AWS 虚拟机实例,则必须将您的 AWS 帐号关联到工作区,之后才能使用 Stackdriver Logging 代理。

如需了解详情,请参阅创建工作区

没有远程软件包访问权限的虚拟机

安装 Logging 代理时需要访问远程软件包代码库以获得代理软件包及其依赖项(在 Linux 上)。如果虚拟机主机的安全政策拒绝访问远程软件包代码库,我们建议在预装代理的情况下创建自定义虚拟机映像,并停用映像中的软件包管理。

在 Linux 和 Windows 上安装

要在运行 Linux 或 Microsoft Windows 的虚拟机实例上安装代理,请使用以下说明。

如果您要尝试启用结构化日志记录,请参阅结构化日志记录安装说明

Linux 实例

  1. 使用 SSH 或类似工具打开到虚拟机实例的终端连接。

  2. 通过在您的虚拟机实例上运行以下命令来下载 Logging 代理的安装脚本:

    curl -sSO https://dl.google.com/cloudagents/install-logging-agent.sh
    
  3. 使用以下命令运行安装脚本:

    sudo bash install-logging-agent.sh
    

您可以在成功运行后删除安装脚本。

Windows 实例

  1. 使用 RDP 或类似工具打开到实例的终端连接,然后登录 Windows。

  2. 如果您使用的是 HTTP 代理,请通过管理员命令提示符运行以下命令。这样做可设置 https_proxy 环境变量,以便代理可以使用出站 HTTPS 将数据发送到 Stackdriver Logging:

    setx https_proxy https://[YOUR_PROXY_SERVER_URI] /m
    
  3. 打开 PowerShell 终端,然后运行以下三个 PowerShell 命令。您不需要具备管理员权限。

    cd $env:UserProfile;
    Invoke-WebRequest https://dl.google.com/cloudagents/windows/StackdriverLogging-v1-9.exe -OutFile StackdriverLogging-v1-9.exe;
    .\StackdriverLogging-v1-9.exe
    

    要以静默方式安装代理,请将 /S 选项附加到安装程序的调用中:

    .\StackdriverLogging-v1-9.exe /S
    

    在“静默”模式下,请使用 /D 选项指定安装目录,例如:

    .\StackdriverLogging-v1-9.exe /S /D="C:\Stackdriver\Logging\"
    

要验证或测试 Stackdriver Logging 代理是否已安装,请参阅验证代理安装

如果您在安装时遇到问题,请参阅排查 Logging 代理问题

其他任务

代理会进行预先配置,以监控某些已知的日志位置。在 Linux 上,这些位置在由安装脚本自动提取的 google-fluentd-catch-all-config 软件包中进行描述。在 Windows 上,代理默认监控 Windows 事件日志。如果要调整代理配置,请参阅配置 Logging 代理

本部分介绍了如何执行以下常见维护任务:确定代理版本、重启代理、升级代理以及卸载代理。

确定版本

要确定 Logging 代理及其配置组件的版本,请运行以下命令:

Linux 实例

在您的实例上运行以下命令:

# For Debian and Ubuntu systems:
dpkg-query --show --showformat \
    '${Package;-45} ${Version;-10} ${Architecture;-8} ${Status;-25}\n' \
    google-fluentd \
    google-fluentd-catch-all-config \
    google-fluentd-catch-all-config-structured

# For Amazon Linux, Red Hat, CentOS, and SUSE systems:
rpm --query --queryformat \
    '%-45{NAME} %-10{VERSION} %-10{RELEASE} %-8{ARCH}\n' \
    google-fluentd \
    google-fluentd-catch-all-config \
    google-fluentd-catch-all-config-structured

Windows 实例

运行以下命令:

reg query HKLM\Software\Wow6432Node\Microsoft\Windows\CurrentVersion\Uninstall\GoogleStackdriverLoggingAgent\ /v Version

如果代理的版本低于 v1-5,上述命令将返回错误。升级到最新版代理

重启代理

您必须重启 Stackdriver Logging 代理才能使配置文件中的更改生效。要重启 Stackdriver Logging 代理,请使用以下说明。

Linux 实例

在您的实例上运行以下命令:

    $ sudo service google-fluentd restart

重启 Logging 代理后,您可能需要发送测试消息

Windows 实例

需要管理员权限:要重启代理,请在虚拟机实例上通过命令提示符或 PowerShell 运行以下命令:

# For Logging agent version v1-5 and later.
net stop  StackdriverLogging
net start StackdriverLogging

# For Logging agents before v1-5.
net stop  fluentdwinsvc
net start fluentdwinsvc

升级代理

要将 Stackdriver Logging 代理升级到最新版本,请使用以下说明:

Linux 实例

要升级到最新的代理版本,请在您的实例上运行以下命令:

# For Debian and Ubuntu systems:
sudo apt-get install --only-upgrade google-fluentd

# For Amazon Linux, Red Hat and CentOS systems:
sudo yum upgrade google-fluentd

# For SUSE systems:
sudo zypper update google-fluentd

上述命令不会更改代理的配置文件。要获取最新的默认配置和内容全面的配置文件,请在您的实例上运行以下命令:

# For Debian and Ubuntu systems:
sudo apt-get install --only-upgrade -o Dpkg::Options::="--force-confnew" google-fluentd-catch-all-config
sudo apt-get install --only-upgrade google-fluentd

# For Amazon Linux, Red Hat and CentOS systems:
sudo yum upgrade google-fluentd google-fluentd-catch-all-config

# For SUSE systems:
sudo zypper update google-fluentd google-fluentd-catch-all-config

或者,您也可以移除当前代理,然后安装最新代理。在执行可能引起配置更改的升级时(例如,在发生主要版本碰撞时),建议您使用此方法。

Windows 实例

要升级到最新的代理版本,请按照在 Windows 上安装中的说明安装最新代理。系统将提示您卸载以前版本的代理。

卸载代理

要移除 Stackdriver Logging 代理及其配置文件,请按照以下说明操作。

Linux 实例

卸载当前的 Linux 代理:

# For Debian and Ubuntu systems:
sudo service google-fluentd stop
sudo apt-get remove google-fluentd google-fluentd-catch-all-config

# For Amazon Linux, Red Hat and CentOS systems:
sudo service google-fluentd stop
sudo yum remove google-fluentd google-fluentd-catch-all-config

# For SUSE systems:
sudo service google-fluentd stop
sudo zypper remove google-fluentd google-fluentd-catch-all-config

Windows 实例

通过运行以下命令卸载当前代理:

[AGENT_INSTALLATION_DIRECTORY]\uninstall.exe

如果您运行的是 Logging 代理 v1-5 及更高版本,请使用安装代理时选择的目录。默认安装目录是:

C:\Program Files (x86)\Stackdriver\LoggingAgent\

如果您运行的 Logging 代理版本低于 v1-5,则安装目录为:

C:\GoogleStackdriverLoggingAgent\

如需了解详情,请参阅配置 Logging 代理

此页内容是否有用?请给出您的反馈和评价:

发送以下问题的反馈:

此网页
Stackdriver Logging
需要帮助?请访问我们的支持页面