[[["容易理解","easyToUnderstand","thumb-up"],["確實解決了我的問題","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["難以理解","hardToUnderstand","thumb-down"],["資訊或程式碼範例有誤","incorrectInformationOrSampleCode","thumb-down"],["缺少我需要的資訊/範例","missingTheInformationSamplesINeed","thumb-down"],["翻譯問題","translationIssue","thumb-down"],["其他","otherDown","thumb-down"]],["上次更新時間:2025-09-04 (世界標準時間)。"],[],[],null,["# Insights\n========\n\nRecommender uses machine learning to provide detailed and high quality\n*insights* . Insights are findings that you can use to proactively focus on\nimportant patterns in resource usage. You can use insights independently from\nrecommendations. Some insights link to\n[recommendations](/recommender/docs/key-concepts#recommendations) and provide\nevidence for the associated recommendations.\n\nThis page describes key concepts for interpreting and using insights.\n\nInsight types\n-------------\n\nEach insight has a specific *insight type*. Insight types are specific to a\nsingle Google Cloud product and resource type. A single product can have\nmultiple insight types, where each provides a different type of insight for a\ndifferent resource.\n\nEach insight type has a unique insight type ID that identifies the service\ninternally. You use the insight type ID when interacting with insights using the\nRecommender [`gcloud` commands](/sdk/gcloud/reference/recommender), or\nthe [REST](/recommender/docs/reference/rest) or\n[RPC](/recommender/docs/reference/rpc) APIs.\n\nFor more information, see [Insight types](/recommender/docs/insights/insight-types).\n\nInsights\n--------\n\nAn *insight* is a machine-generated finding that may be linked to one or more\nrecommendations. An insight has the following core attributes:\n\n- [Name](#name)\n- [Description](#description)\n- [Insight Subtype](#insight_subtype)\n- [Content](#content)\n- [Category](#category)\n- [Target Resources](#target_resources)\n- [State Info](#state_info)\n- [Etag](#etag)\n- [Severity](#severity)\n- [Last Refresh Time](#last_refresh_time)\n- [Observation Period](#observation_period)\n- [Recommendation reference](#recommendation_reference)\n\n### Name\n\nThe insight name is stored in the `name` field of the Insight entity. It has\nthe following format: \n\n```\nprojects/TARGET_PROJECT_ID/locations/LOCATION/insightTypes/INSIGHT_TYPE_ID/insights/INSIGHT_ID\n```\n\nwhere:\n\n- \u003cvar translate=\"no\"\u003eTARGET_PROJECT_ID\u003c/var\u003e is the ID of the project where the insight was generated.\n- \u003cvar translate=\"no\"\u003eLOCATION\u003c/var\u003e is the Google Cloud [location](/compute/docs/regions-zones) where resources associated with the insight are located (for example,`global` or `us-central1-a`)\n- \u003cvar translate=\"no\"\u003eINSIGHT_TYPE_ID\u003c/var\u003e is the fully-qualified insight type ID (for example, `google.compute.firewall.Insight`)\n- \u003cvar translate=\"no\"\u003eINSIGHT_ID\u003c/var\u003e is a unique ID for the insight\n\n### Description\n\nThis is human-readable summary of the insight. It is only available in\nEnglish.\n\n### Insight Subtype\n\nEach insight type may support multiple subtypes. The content schema is stable\nfor a given subtype.\n\n### Content\n\nStructured fields that include insight details. Content schema is determined by\ninsight type and subtype. For example, `\"grantedPermissionsCount\": \"1000\"`\n\n### Category\n\nSimilar to [impacts](/recommender/docs/key-concepts#impact) for recommendations,\nthere are categories for insights:\n\n- `COST`\n- `SECURITY`\n- `PERFORMANCE`\n\n### Target Resources\n\nFully qualified resource names of the Google Cloud resources the insight is targeting.\n\n### State Info\n\n#### State\n\nInsights go through multiple state transitions after they are proposed:\n\n- `ACTIVE`, which means that the insight has been generated, but no actions have been taken in response. Content for active insights is updated when the underlying data changes. Active insights can be marked `DISMISSED` OR `ACCEPTED`.\n- `ACCEPTED`, which means that some action has been taken based on the insight. Insights become accepted when an associated recommendation has been marked `CLAIMED`, `SUCCEEDED`, or `FAILED`. Insights can also be accepted directly. Content for accepted insights is immutable. Accepted insights are retained for 90 days from the time of the state change.\n- `DISMISSED`, which means that the insight has been dismissed without taking any action based on it. Content for dismissed insights is updated when the underlying data changes.\n\n#### State Metadata\n\nWhen directly marking an insight ACCEPTED, you can include additional metadata\nabout the operation with state metadata. The metadata is specified as\n`key:value` pairs. Updates to the state metadata field overwrite any existing\nstate metadata.\n\n### Etag\n\nAn *etag* is a unique fingerprint that identifies the current state of an\ninsight. Each time the insight changes, a new etag value is assigned. \n\nIn order to change insight state, you must provide the etag of the existing\ninsight. This makes sure that any operations are performed only if the insight\nhas not changed since you last retrieved it.\n\n### Severity\n\nA [*severity*](/recommender/docs/reference/rest/v1/billingAccounts.locations.insightTypes.insights#severity)\nfor an insight indicates the likelihood of one of the following [impacts](/recommender/docs/key-concepts#impact):\n\n- An outage (for a performance impact)\n- A compromise (for a security impact)\n- An overspend (for a cost impact)\n- A mismanagement (for a manageability impact)\n\nThis field comes with values `CRITICAL`, `HIGH`, `MEDIUM`, and `LOW` with `LOW` set as the\ndefault severity.\nEach [insight type](/recommender/docs/insights/insight-types) can have its own\nseverity strategy defined.\n\n### Last Refresh Time\n\nThe last refresh time indicates the freshness of the data used to generate the\ninsight.\n\n### Observation Period\n\nObservation period is the time period leading up to the insight. The source data\nused to generate the insight ends at`last_refresh_time` and begins at\n`last_refresh_time` minus `observation_period`.\n\n### Recommendation reference\n\nReference to an associated\n[recommendation](/recommender/docs/key-concepts#recommendations). References\nlink insights with their associated recommendations. This field is empty when\nthere are no recommendations derived from the insight."]]