insighttops -配置Insight Agen必威体育app登录t发送日志

Insi必威体育app登录ght Agent将资产日志数据通过一个名为dota2必威联赛logging.json.。默认情况下,logging.json.文件指示代理将日志直接发送到data.logs.insight.rapid7.com终点根据您所在的地点,但你可以配置一个代理的目的地如果有必要的话)。

本文介绍了如何生成一个logging.json.Insightops中的文件,通过操作系统提供示例格式,并定义文件包含的JSON对象。

代理配置

如果您愿意通过代理而不是直接到Insight平台发送资产日志数据,可以通过在整体中添加以下附加密钥值对来执行此操作dota2必威联赛配置你的对象logging.json.文件:

  • 代理类型- 指定应用程序协议。此时,只有HTTP是支持的。
  • Proxy-URL.- 指定代理服务器的地址。这可以是主机名或IP地址。
  • 代理端口-指定Insight Agent将使用的端口与您的代理服务器必威体育app登录通信。

您可以将收集器指定为代理

如果您已经在您的环境中部署了一个或多个collector,那么您可以将其中一个作为此用例的代理。Insi必威体育app登录ght Agent与insighttops相关的收集任务不能区分Collector或其他代理类型。指定其中任何一个都可以达到到达internet的相同目标。

对象配置logging.json.对于收集器的地址保持不变,除了代理端口必须设置为8037按照收集器要求。

此示例显示了如何格式化代理定义logging.json.

          
json
1
2
“配置”
3.
“代理类型”“HTTP”
4
“proxy-url”“10.7.1.219”
5
“代理端口”“3128”
6
...然后是你的对象的其余部分
7
8

logging.json创建向导

在Insight必威体育app登录ops中使用Insight代理数据源向导自动创建和格式化alogging.json.包含API密钥和数据区域的文件。之后,您可以直接从向导下载完整的文件。

您必须手动创建代理对象

logging.json.Insightops中的创建向导目前尚未包含先前描述的代理相关对象。如果您希望代理通过代理发送日志,则必须编辑您的logging.json.下载后文件并手动添加代理对象。

创建日志。jsonfile with the wizard:

  1. 在“insighttops”中,单击添加数据按钮。
    • 或者,您可以单击添加数据链接位于日志搜索或者数据收集标签。
  2. 在“安装Insight Agent”部分必威体育app登录中,单击您打算安装代理的资产的操作系统。

提示

向导将假定您还没有在资产上安装Insight Agent,所以如果您已经安装了,可以跳过安装步骤。必威体育app登录

  1. 在“通过Insight Agent发送日志”必威体育app登录面板上,选择使用现有的API密钥或生成新的API密钥:
    • 如果您正在使用现有的API密钥,请将密钥粘贴到字段中,然后单击应用按钮。
    • 如果您正在生成新的API密钥,请单击生成API键按钮,然后点击应用按钮。Mac代理日志
  2. 验证您的格式化logging.json.文件包括API密钥、数据区域端点和区域代码。注意,'destination'字段中的主机名可以根据需要更改。点击下载检索您的文件。
  3. 把你的logging.json.根据你的资产的操作系统,在以下目录中的一个文件:
    • 视窗-C:\Program Files\Rapid7\必威体育app登录Insight代理\ \ insight_agent \常见\配置组件
    • Mac和Linux-/ opt / rapid7 / ir_agent /组件/ insight_agent /共同/配置
  4. 最后,重新启动Insight代理服务。必威体育app登录
    • 在Windows上,该服务在服务管理器中称为“Rapid7 Insight Agent必威体育app登录”。
    • 在Mac和Linux操作系统下,可以通过运行Sudo服务ir_agent重启在终端中的命令。

logging.json.Formatting Templates

如果你更喜欢创造你的logging.json.文件手动文件,请参阅以下模板。

Mac和Linux

的Mac和Linux版本logging.json.具有以下结构:

          
logging.json.
1
2
“配置”
3.
“名称”“您的日志配置的标签”
4
“端点”“eu.data.logs.insight.rapid7.com”
5
“地区”“欧洲联盟”
6
“api键”“你的API键”
7
“状态文件”“/ opt / rapid7 / ir_agent /组件/ insight_agent /共同/ config / logs.state”
8
“格式化程序”“清楚的”
9
“指标”
10.
“system-stat-token”“你的日志令牌在这里”
11.
“System-Stat启用”真正的
12.
“指数间隔”“六十年代”
13.
“metrics-cpu”“系统”
14.
“metrics-vcpu”“核”
15.
“metrics-mem”“系统”
16.
“metrics-swap”“系统”
17.
“metrics-net”“eth0总和”
18.
“指标磁盘”“SUM SDA4 SDA5”
19.
“metrics-space”“/”
20.
21.
“日志”(
22.
23.
“名称”“系统日志”
24.
“目的地”“服务器名/ syslog”
25.
“小路”“/ var / log / syslog”
26.
“启用”真正的
27.
28.
29.
“名称”“内核”
30.
“目的地”“您的服务器 - 名称/内核”
31.
“小路”“/ var / log / kern.log”
32.
“启用”真正的
33.
34.
35.
“名称”“身份验证”
36.
“目的地”“您的服务器 - 名称/ auth”
37.
“小路”“/ var / log / auth.log”
38.
“启用”真正的
39.
40
41.
“名称”“必威体育app登录洞察代理日志”
42.
“令牌”“你的日志令牌在这里”
43.
“小路”“/opt/rapid7/ir_agent/components/insight_agent/common/agent.log”
44.
“启用”
45.
46.
47.

视窗

—不支持从域控制器收集事件日志

Insight Agent的insighttops组件目前不支持必威体育app登录从充当域控制器的资产收集事件日志。如果您需要为这个用例部署一个集合方法,请考虑实现以下备选方案之一:

的Windows版本logging.json.具有以下结构:

          
logging.json.
1
2
“配置”
3.
“名称”“您的日志配置的标签”
4
“端点”“eu.data.logs.insight.rapid7.com”
5
“地区”“欧洲联盟”
6
“api键”“你的API键”
7
“状态文件”“C: \ \程序文件\ \ Rapid7 \ \洞察力必威体育app登录代理组件\ \ \ \ insight_agent \ \常见\ \ state.file”
8
“格式化程序”“清楚的”
9
“指标”
10.
“system-stat-token”“你的日志令牌在这里”
11.
“System-Stat启用”真正的
12.
“指数间隔”“六十年代”
13.
“metrics-cpu”“系统”
14.
“metrics-vcpu”“核”
15.
“metrics-mem”“系统”
16.
“metrics-swap”“系统”
17.
“metrics-net”“eth0总和”
18.
“指标磁盘”“SUM SDA4 SDA5”
19.
“metrics-space”“/”
20.
21.
“Windows-eventlog”
22.
“启用”真正的
23.
“令牌”“cfe50cc8 - 7651 - 42 - f3 ac23 - 866 bf87a6aad”
24.
25.
“日志”(
26.
27.
“名称”“自定义日志”
28.
“目的地”“服务器名/自定义日志”
29.
“小路”“c: \ \ logs \ \ mylogfile * . log”
30.
“启用”真正的
31.
32.
33.
“名称”“必威体育app登录洞察代理日志”
34.
“令牌”“你的日志令牌在这里”
35.
“小路”“C: \ \程序文件\ \ Rapid7 \ \洞察力必威体育app登录代理组件\ \ \ \ insight_agent \ \常见\ \ agent.log”
36.
“启用”
37.
38.
39.

对象的传说

对象

描述

姓名

标签的配置,供您自己参考。

终点

代理应该将日志数据转发到的日志数据端点。例如:
美联社-ap.data.logs.insight.rapid7.com
非盟-au.data.logs.insight.rapid7.com
CA-ca.data.logs.insight.rapid7.com
欧盟-eu.data.logs.insight.rapid7.com
US-1-us.data.logs.insight.rapid7.com
2-US2.DATA.LOGS.ILSIGHT.RAPID7.com.
我们三个-us3.data.logs.insight.rapid7.com

地区

您部署Insightops的特定区域是基于的。例如:
美联社非盟ca欧盟我们2卖价

api密匙

这是你的读写API键,可以在设置> API键

状态文件

这是一个本地文件的路径,该文件跟踪发送到insighttops的最后一个条目。当代理重新启动时,它将从该点发送日志,以减少代理脱机时丢失的日志数据。

格式化程序

将格式化程序设置为“plain”将条目完全按照写入本地日志文件的方式发送到InsightOps。

如果您希望日志行以Syslog格式RFC 5424发送——添加时间戳、主机和其他信息,则删除此字段。

指标

通过本节,您可以将主机的资源利用率指标发送给insighttops。

system-stat-token

在此字段中输入日志令牌以定义哪些日志将在Insigrops中接收指标数据。您可以使用>快速添加在应用程序中。

Windows-eventlog.

本节定义是否要从Windows事件日志中自动收集条目。为了便于搜索分析,这些条目将被转换为JSON。

这不适用于域控制器。

令牌

在此字段中输入一个日志令牌,定义将在insighttops中接收Windows事件的日志。您可以使用>快速添加在应用程序中。

日志

这一部分是您想要遵循的主机上的日志文件列表。当新的行被写入这些日志时,更新将被实时发送到InsightOps。

姓名

标签的配置,供您自己参考。

目的地

使用时,该字段将自动创建一个日志集,如果不存在匹配的日志集,则创建一个日志集。

将该字段替换为令牌字段,如果要在insighttops中写入现有日志或在insighttops的一个位置聚合日志数据。

路径

这是您希望在运行代理的主机上遵循的文件的路径。对于Windows计算机上的文件,您需要转发反斜杠。例如:
“路径”:“C:\\ logs \\ mylogfile.log”

Insightops支持对某些不允许您指定绝对目标文件名的某些日志翻转策略的日志文件旋转。当日志文件是时间戳或分配顺序编号时,这是典型的。您可以在文件名中指定通配符,因此匹配指定目录中的模式的任何活动日志文件的内容将转发到Insigrops中的相同日志。请注意,Insight代理无法观看目必威体育app登录录本身。相反,它旨在观看在日期和序号上旋转的日志,或Syslog旋转。

例如:

“路径”:“c: \ \ logs \ \ mylogfile - * . log”


在指定通配符规则时,请确保将通配符锚定在特定的日志文件名基上。不要指定非锚定通配符,比如“路径”:“c: \ \ \ \ * . log日志”,因为这将拉出任何和所有日志文件被写入指定目录并导致衡量数据传输量。


请注意,在典型的Syslog旋转方案中,通配符不是必需的。典型方案将通过重命名原始来执行此旋转logname.log.logname.log.0在创建一个新的logname.log.更换它。在这种情况下,您只需要指定logname.log.它本身没有任何通配符。

启用

这是一个布尔值真正的或者用于指定是否应该跟随该文件。

代理类型

指定应用程序协议。此时,只有HTTP是支持的。

Proxy-URL.

指定代理服务器的地址。这可以是主机名或IP地址。

代理端口

指定Insight Agent将用于与代理服务器通信的端必威体育app登录口。如果在代理定义中指定Collector,则必须将其设置为8037