本页面介绍了如何列出、描述、关闭、恢复和导出分析洞见。
所需的角色和权限
如需获得管理和导出分析洞见所需的权限，请让您的管理员向您授予项目的以下 IAM 角色：
-
Firewall Recommender Admin (
roles/recommender.firewallAdmin) -
Firewall Recommender Viewer (
roles/recommender.firewallViewer)
如需详细了解如何授予角色，请参阅管理对项目、文件夹和组织的访问权限。
这些预定义角色可提供管理和导出分析洞见所需的权限。如需查看所需的确切权限，请展开所需权限部分：
所需权限
必须拥有以下权限才能管理和导出分析洞见：
-
recommender.computeFirewallInsights.list -
recommender.computeFirewallInsights.update
列出针对一个项目的数据分析
如需列出项目的分析洞见，请执行以下操作：
gcloud
使用 gcloud recommender insights list 命令：
gcloud recommender insights list \
--project=PROJECT_ID \
--location=global \
--insight-type=google.compute.firewall.Insight \
--filter=EXPRESSION \
--limit=LIMIT \
--page-size=PAGE_SIZE \
--sort-by=SORT_BY \
--format=json
将 PROJECT_ID 替换为您要列出其数据分析的项目 ID。
location 标志始终使用名为 global 的位置。insight-type 标志始终使用名为 google.compute.firewall.Insight 的数据分析类型。除非您使用 JSON 格式化输出，否则命令输出将以表格形式显示。
以下字段是可选的：
EXPRESSION：将此布尔过滤条件应用于您要列出的每个资源。如果表达式的计算结果为
True，则系统会列出相应项。如需了解详情以及过滤条件表达式的示例，请运行$ gcloud topic filters或查看gcloud topic filters文档。LIMIT：要列出的资源数上限；列出的默认资源数量不受限制PAGE_SIZE：每页列出的资源数上限默认页大小由服务确定，否则不进行分页。可以在
FILTER和LIMIT之前或之后应用分页。SORT_BY：对资源排序所依据的以逗号分隔的字段键名称列表默认顺序是升序。如需指定降序，请在相应字段前面加上
~（波浪号）。
API
向 projects.locations.insightTypes.insights 方法发出 GET 请求：
GET https://recommender.googleapis.com/v1/{parent=projects/*/locations/global/insightTypes/*}/insights
以下示例展示了此命令的示例响应：
insights {
"name": "projects/{project_number}/locations/global/insightTypes/google.compute.firewall.Insight/insights/{insight-id}"
"description": "Firewall projects/{project_id}/global/firewalls/{shadowed_firewall_name} is shadowed by projects/{project_id}/global/firewalls/{shadowing_firewall_name}."
"content": {
"shadowingFirewalls": [
"//compute.googleapis.com/projects/{project_id}/global/firewalls/{shadowing_firewall_name1}"
]
},
"lastRefreshTime": "2020-04-01T19:16:43Z",
"observationPeriod": "0s",
"stateInfo" {
"state": "ACTIVE"
}
"category": "SECURITY"
"targetResources":[
"//compute.googleapis.com/projects/{project_id}/global/firewalls/{shadowed_firewall_name}"
],
"insightSubtype": "SHADOWED_RULE"
}
描述数据分析
如需详细描述项目中的特定防火墙规则，请执行以下操作：
gcloud
使用 gcloud recommender insights describe 命令：
gcloud recommender insights describe INSIGHT_ID \
--project=PROJECT_NAME \
--location=global \
--insight-type=google.compute.firewall.Insight
请替换以下内容：
INSIGHT_ID：要描述的数据分析 IDPROJECT_NAME：您要列出其数据分析的项目的名称
location 标志始终使用名为 global 的位置。insight-type 标志始终使用名为 google.compute.firewall.Insight 的数据分析类型。
API
向 projects.locations.insightTypes.insights 方法发出 GET 请求：
GET
https://recommender.googleapis.com/v1/{name=projects/*/locations/global/insightTypes/*/insights/*}
{
"name": projects/PROJECT_ID/locations/LOCATION/insightTypes/INSIGHT_TYPE_ID/insights/INSIGHT_ID,
}
请替换以下内容：
PROJECT_ID：项目 IDLOCATION：始终使用名为global的位置INSIGHT_TYPE_ID：始终使用值google.compute.firewall.InsightINSIGHT_ID：分析洞见的 ID
将数据分析标记为已忽略
如果所有数据分析都没有意义，或者如果您出于任何其他原因想要隐藏它，则可以忽略它。忽略分析洞见后，除非您将其恢复，否则 Google Cloud 控制台将不再向您或其他用户显示该分析洞见。
如需将分析洞见标记为已关闭，请执行以下操作：
控制台
在 Google Cloud 控制台中，前往防火墙数据分析页面。
找到相应的卡片，然后点击查看完整列表。
选择要忽略的规则，然后点击忽略。
恢复已忽略的数据分析
如果您忽略了之后认为相关的分析洞见，您或其他用户可以恢复它并使其在 Google Cloud 控制台中可见。
如需恢复已关闭的分析洞见，请执行以下操作：
控制台
在 Google Cloud 控制台中，前往防火墙数据分析页面。
点击忽略历史记录。在响应中， Google Cloud 控制台会显示已忽略的分析洞见页面。
选择要恢复的数据分析，然后点击恢复。
导出数据分析
如果需要，您可以使用 CSV 或 JSON 格式导出被屏蔽的和过度宽松的规则分析洞见。Deny rules with hits 信息无法导出，因为它基于防火墙 Stackdriver 指标，而非分析洞见。
出于以下原因，您可能需要导出数据分析：
- 您需要将数据导入另一系统。
- 您希望离线访问数据。
- 您打算停用防火墙数据分析，但希望保留对以前生成的数据分析的访问权限。
如需导出分析洞见，请执行以下操作：
控制台
在 Google Cloud 控制台中，前往防火墙数据分析页面。
点击另存为。
按照提示选择数据分析格式并下载。
您还可以将分析洞见导出到 BigQuery。将分析洞见导出到 BigQuery 时，您可以查看组织的分析洞见的每日快照。如需了解详情，请参阅将建议导出到 BigQuery。