Configure ACI Monitoring Policies - Modify Interface Stats History Retention Period

简介

本文档介绍修改ACI监控策略的步骤，特别是接口统计信息的历史记录保留期。

先决条件

要求

本文档没有任何特定的要求。

使用的组件

本文档中的信息基于ACI软件版本5.2(2e)。

本文档中的信息都是基于特定实验室环境中的设备编写的。本文档中使用的所有设备最初均采用原始（默认）配置。如果您的网络处于活动状态，请确保您了解所有命令的潜在影响。

背景信息

接口统计信息位于Fabric > Inventory > Pod x > Interfaces > Physical Interfaces > ethx/y > Stats选项卡。

在此统计信息视图中，应用粒度的“历史记录保留期”以保留以下记录：

• 出口字节总数
• 出口字节总速率
• 入口字节总数
• 总入口字节速率
• CRC对齐错误

本文包含修改“15分钟”粒度的历史记录保留期的步骤。“15分钟”的历史记录保留期的默认值为1天。

文章内容可以根据需要适应其他粒度值。

配置

统计信息收集策略遵循分层结构和解析流程，可以总结为下图：

--- MonObj "ALL"  +  Stats Type "ALL"
 |
 |--- MonObj "className" + Stats Type "ALL"
   |     
   |--- MonObj "className" + Stats Type "Specific-value"

具有明确定义的统计信息类型值（最低级别）的特定监控对象(MonObjs)优先。如果未定义，它们将解析为上一级别的值，直到全局监控对象“ALL”和统计类型“ALL”。

如果未定义其他已命名的监控策略且正在使用中，则“默认”监控策略中的统计信息收集策略可用于修改整个ACI交换矩阵的统计信息粒度和历史记录保留期。

通过GUI配置

1. 在顶部菜单栏中，单击Fabric，然后单击Access Policies。
2. 在导航窗格中，依次展开Policies、Monitoring和default。
3. 单击Stats Collection Policies文件夹。
4. 配置在右侧窗格中继续。有3个选项：
   1. 修改统计类型为“ALL”的全局监控对象“ALL”
   2. 使用统计信息类型“ALL”修改“第1层物理接口配置(l1.Physif)”监控对象
   3. 使用特定统计信息类型“出口”、“入口”和“入口错误数据包”修改“第1层物理接口配置(l1.Physif)”

选项A、B和C可视为：

--- MonObj "ALL"  +  Stats Type "ALL"               - Option A
 |
 |--- MonObj "l1Physif" + Stats Type "ALL"          - Option B
   |     
   |--- MonObj "l1Physif" + Stats Type "Egress"...  - Option C

选项C是最具体的选项，它仅允许修改“背景信息”部分中提到的统计信息。但是，本文回顾了其他选项的流程，以帮助理解层次结构。

注意：选项A或B会修改MonObjs和统计信息类型的统计信息收集策略，而不是在“背景信息”部分中指定的策略。

选项A — 监控对象“ALL” +统计信息类型“ALL”

1. 确保已选择监控对象“ALL”和统计类型“ALL”
2. 查找“15分钟”粒度条目。
3. 确保其Admin State设置为“enabled”
4. 将History Retention Period更改为本文所需的时间“1周”。
5. 单击更新。

在此方案中，1周的历史记录保留期适用于所有统计类型的所有监控对象的15分钟精细度。这会增加整个ACI交换矩阵中的对象保留率。

选项B — 监控对象“l1.Physif” +统计信息类型“ALL”

1. 确保已选择监控对象“第1层物理接口配置(l1.Physif)”和统计类型“ALL”
2. 点击“+”图标
3. 选择“15分钟”粒度条目。
4. 确保其Admin State设置为“enabled”
5. 将History Retention Period更改为本文所需的时间“1周”。
6. 单击更新。

在此方案中，1周的历史记录保留期适用于所有统计信息类型的所有接口的15分钟精细度。由于更改的作用域是L1Physif，因此这是一种更受控制的方法。

选项C — 监控对象“l1.Physif” +特定统计信息类型

要修改的统计信息类型为“出口”、“入口”和“入口错误数据包”

1. 确保已选择监控对象“第1层物理接口配置(l1.Physif)”和统计类型“出口”
2. 点击“+”图标
3. 选择“15分钟”粒度条目。
4. 确保其Admin State设置为“enabled”
5. 将History Retention Period更改为本文所需的时间“1周”。
6. 单击更新。
7. 对统计信息类型“入口”和“入口错误数据包”重复

在此方案中，1周的历史记录保留期应用于接口15分钟粒度，仅适用于出口、入口和入口错误数据包统计类型。这是最受控制的方法，因为更改的范围是针对特定统计类型。

验证

可通过APIC CLI和GUI验证15分钟的历史记录保留期限。

在本文中，历史记录保留期为：

监控对象	统计信息类型	历史记录保留期
全部	全部	1 天
第1层物理接口配置(l1.Physif)	全部	1 周
第1层物理接口配置(l1.Physif)	出口	1 周
第1层物理接口配置(l1.Physif)	入口	1 小时
第1层物理接口配置(l1.Physif)	入口错误数据包	10 天

通过APIC CLI验证

从API可以查询这些对象以验证不同级别的监控策略：

uni/infra/moninfra-default/coll-15min
uni/infra/moninfra-default/tarinfra-l1PhysIf/coll-15min
uni/infra/moninfra-default/tarinfra-l1PhysIf/stat-eqptIngrTotal/coll-15min
uni/infra/moninfra-default/tarinfra-l1PhysIf/stat-eqptEgrTotal/coll-15min
uni/infra/moninfra-default/tarinfra-l1PhysIf/stat-eqptIngrErrPkts/coll-15min

通过APIC CLI对这些对象使用moquery:

apic1# moquery -d uni/infra/moninfra-default/coll-15min
Total Objects shown: 1

# stats.HierColl
granularity  : 15min
adminState   : enabled
dn           : uni/infra/moninfra-default/coll-15min
histRet      : 1d
modTs        : 2022-05-20T13:03:05.311+02:00
rn           : coll-15min
userdom      : all


apic1# moquery -d uni/infra/moninfra-default/tarinfra-l1PhysIf/coll-15min
Total Objects shown: 1

# stats.HierColl
granularity  : 15min
adminState   : enabled
dn           : uni/infra/moninfra-default/tarinfra-l1PhysIf/coll-15min
histRet      : 1w
modTs        : 2022-05-16T16:15:58.031+02:00
rn           : coll-15min
userdom      : :all:common:


apic1# moquery -d uni/infra/moninfra-default/tarinfra-l1PhysIf/stat-eqptEgrTotal/coll-15min
Total Objects shown: 1

# stats.Coll
granularity  : 15min
adminState   : enabled
dn           : uni/infra/moninfra-default/tarinfra-l1PhysIf/stat-eqptEgrTotal/coll-15min
histRet      : 1w
modTs        : 2022-05-16T16:16:54.786+02:00
rn           : coll-15min
userdom      : :all:common:


apic1# moquery -d uni/infra/moninfra-default/tarinfra-l1PhysIf/stat-eqptIngrTotal/coll-15min
Total Objects shown: 1

# stats.Coll
granularity  : 15min
adminState   : enabled
dn           : uni/infra/moninfra-default/tarinfra-l1PhysIf/stat-eqptIngrTotal/coll-15min
histRet      : 1h
modTs        : 2022-05-16T16:21:25.962+02:00
rn           : coll-15min
userdom      : :all:common:


apic1# moquery -d uni/infra/moninfra-default/tarinfra-l1PhysIf/stat-eqptIngrErrPkts/coll-15min
Total Objects shown: 1

# stats.Coll
granularity  : 15min
adminState   : enabled
dn           : uni/infra/moninfra-default/tarinfra-l1PhysIf/stat-eqptIngrErrPkts/coll-15min
histRet      : 10d
modTs        : 2022-05-20T13:03:24.715+02:00
rn           : coll-15min
userdom      : :all:common:

通过GUI验证

经过配置的历史记录保留期后，可从Interface Stats页面查看结果。

Fabric > Inventory > Pod x > Interfaces > Physical Interfaces > ethx/y > Stats选项卡：

要验证15分钟粒度更改，请执行以下操作：

1. 点击左上角的复选框图标
2. 选择采样间隔“15分钟”（使用默认单元类型）
3. 单击“Submit”。

要验证此界面中的所有可用统计信息，请将Zoom更改为"All"

请注意，1天（“ALL” + Stats类型“ALL”）和1周（“L1Physif” + Stats类型“ALL”）的15分钟粒度历史记录保留期未使用。

相反，特定统计类型定义 

• 1周（“出口”）
• 1小时（“入口”）
• 10天（“入口错误数据包”）

已经生效。