From 83dc6424952f0fdc187d4d73d63df1634aed358e Mon Sep 17 00:00:00 2001 From: James Denyer Date: Thu, 9 Jan 2025 10:57:14 -0800 Subject: [PATCH 1/4] fixing a few broken links --- content/docs/insights/concepts/_index.md | 4 +- content/docs/insights/search.md | 4 +- content/docs/pulumi-cloud/insights/_index.md | 102 ------------------- 3 files changed, 4 insertions(+), 106 deletions(-) delete mode 100644 content/docs/pulumi-cloud/insights/_index.md diff --git a/content/docs/insights/concepts/_index.md b/content/docs/insights/concepts/_index.md index 15d22b72f423..fb5b0230a24a 100644 --- a/content/docs/insights/concepts/_index.md +++ b/content/docs/insights/concepts/_index.md @@ -44,7 +44,7 @@ A count is shown in the upper-right corner with the total number of resources ma The table of resources is paginated using infinite scroll so you are able to view up to **10,000** resources without needing to go page by page: {{% notes "info" %}} -If you need access to more resources, you can use the [Data Export](export) feature or access them programmatically via the [Pulumi Cloud Rest API](/docs/pulumi-cloud/cloud-rest-api#resource-search). +If you need access to more resources, you can use the [Data Export](/docs/insights/export/) feature or access them programmatically via the [Pulumi Cloud Rest API](/docs/pulumi-cloud/cloud-rest-api#resource-search). {{% /notes %}} Use the **search bar**, **row grouping**, or **column filters** to refine the resources displayed on the page. @@ -100,7 +100,7 @@ If you don't see it in your organization, [contact us](/contact?form=sales). Organizations with Data Export enabled are able to export all resources matching a particular query in CSV format. -For a more detailed description of CSV schema, see the [export documentation](export). +For a more detailed description of CSV schema, see the [export documentation](/docs/insights/export/). ## APIs diff --git a/content/docs/insights/search.md b/content/docs/insights/search.md index 4f7044c01efe..c805c601b7bb 100644 --- a/content/docs/insights/search.md +++ b/content/docs/insights/search.md @@ -330,7 +330,7 @@ Existence queries do not return resources where the property is an empty object Expanding the "Column Filter" menu shows you the set of values found for that column along with a count for each value. You can then select a specific value or collection of values to filter your result set. -![Resource Search Column Filter](/docs/esc/assets/column-filter.png) +![Resource Search Column Filter](/docs/insights/assets/column-filter.png) In the example above, the query has been restricted to the "dev" stack. @@ -378,7 +378,7 @@ You may want to expand the "Advanced filtering" menu if you are interested in sp You do not need to query AI Assist with English: -![AI Assist](/docs/esc/assets/search-ai.png) +![AI Assist](/docs/insights/assets/search-ai.png) > (type:aws:ec2/instance:Instance OR type:azure:compute:VirtualMachine OR type:gcp:compute:Instance) diff --git a/content/docs/pulumi-cloud/insights/_index.md b/content/docs/pulumi-cloud/insights/_index.md deleted file mode 100644 index 4d842531f2a1..000000000000 --- a/content/docs/pulumi-cloud/insights/_index.md +++ /dev/null @@ -1,102 +0,0 @@ ---- -title_tag: "Pulumi Insights Overview" -meta_desc: Pulumi Insights provides advanced search, analytics, and AI for your infrastructure as code. -title: Pulumi Insights Concepts -h1: Pulumi Insights Concepts -meta_image: /images/docs/meta-images/docs-meta.png -menu: -aliases: ---- - -Pulumi Insights provides advanced search, analytics, and AI for your infrastructure as code. - -It provides: - -- **Resource Search**: Explore all of your resources under management. - Filter, group, search, and sort resources by stack, project, or a number of other dimensions. - -- **Resource Search Aggregates**: See aggregates at a glance for your resources under management. - Start with a birds-eye view of your infrastructure, and leverage features like search, grouping, and filtering to dig deeper. - -- **Resource Search Favoriting and Sharing**: Save your updated view as a favorite in the left nav like stacks or share it with your teammates. - -- **Resource Search AI Assist**: (experimental) Use natural language processing to help craft search queries to explore your data. - -- **Data Export**: Export your Pulumi resources into your business intelligence tool of choice to go even further. - -- **Cloud Import**: Bring your own cloud provider account and import all your existing resources into Pulumi to see how things break down. Zero code required. - -## Resource search - -Resource Search can be accessed directly from the Pulumi Cloud dashboard or from the side navigation by navigating to **Resources**. - -By default, you will see a table with the resources you have access to, ordered by most recently updated. - -A count is shown in the upper-right corner with the total number of resources matched by this query -- in this case, we have 13 resources. - -![Resource Search Table](search-table-v2.png) - -The table of resources is paginated using infinite scroll so you are able to view up to **10,000** resources without needing to go page by page: - -{{% notes "info" %}} -If you need access to more resources, you can use the [Data Export](export) feature or access them programmatically via the [Pulumi Cloud Rest API](/docs/pulumi-cloud/cloud-rest-api#resource-search). -{{% /notes %}} - -Use the **search bar**, **row grouping**, or **column filters** to refine the resources displayed on the page. - -Selecting **project** will pre-populate a query with `project:` which we can then extend to `project:production` to return resources with "production" in their project name. - -![Resource Search Filter Helper](search-filter-helper.png) - -The columns displayed on results can be modified to show or hide information by selecting the **gear icon** and clicking the **Choose columns**. - -![Resource Search Options Gear](gear-icon-dropdown.png) - -You will then see the **Column menu** appear, where you can choose the columns to display. - -![Resource Search Column Chooser](column-chooser.png) - -Selecting a column header will modify the query to sort by that column. - -### Resource search aggregates - -The **Column Filter** menu can be expanded to apply additional filters to each column and to view finer-grained resource sets. - -![Resource Search Column Filter](column-filter.png) - -In this example, the query has been restricted to the "dev" stack. - -### Resource search grouping - -The **Row Groups Header** allows you to drag columns from the table to enable grouping by that column. You can group by multiple columns at once. In this example, we have grouped by stack and modified so that we can see a breakdown of resources by stack and when they were last modified. - -![Resource Search Grouping](resource-search-grouping.png) - -Selecting the **"X" in the search bar** will remove all previously selected filters. - -![Resource Search Clear Filters](clear-search.png) - -### Resource search favoriting - -The **Favorites Button** allows you to save a particular view of the resources page which includes any filters, grouping, column changes, and search queries made. - -![Resource Search Favorites left nav](favorites-left-nav.png) - -All your saved favorites can be seen as quick links on the **left nav**. - -![Resource Search Favorites button](favorites-button.png) - -## Data export - -{{% notes "info" %}} -This feature is only available to organizations using the Enterprise and Business Critical editions. -If you don't see it in your organization, [contact us](/contact?form=sales). -{{% /notes %}} - -Organizations with Data Export enabled are able to export all resources matching a particular query in CSV format. - -For a more detailed description of CSV schema, see the [export documentation](export). - -## APIs - -See the [Pulumi Cloud REST API](/docs/pulumi-cloud/cloud-rest-api#resource-search) for full details of the API endpoint to query and export resources. From 8d60bc0f24e13917e539a55e316aa2be9628bb81 Mon Sep 17 00:00:00 2001 From: James Denyer Date: Thu, 9 Jan 2025 11:07:27 -0800 Subject: [PATCH 2/4] preview link failed, trying again From eadde0ba831a29929ad8dddec8c716fb290f9714 Mon Sep 17 00:00:00 2001 From: James Denyer Date: Thu, 9 Jan 2025 12:02:34 -0800 Subject: [PATCH 3/4] adding alias --- content/docs/insights/concepts/_index.md | 1 + 1 file changed, 1 insertion(+) diff --git a/content/docs/insights/concepts/_index.md b/content/docs/insights/concepts/_index.md index fb5b0230a24a..1c49aec92b03 100644 --- a/content/docs/insights/concepts/_index.md +++ b/content/docs/insights/concepts/_index.md @@ -11,6 +11,7 @@ menu: weight: 2 aliases: - /docs/intro/insights/ +- /docs/pulumi-cloud/insights/ --- Pulumi Insights provides advanced search, analytics, and AI for your infrastructure as code. From fc4c200e4319f7298b8d24e0e87082b73e60bf19 Mon Sep 17 00:00:00 2001 From: James Denyer Date: Thu, 9 Jan 2025 12:35:02 -0800 Subject: [PATCH 4/4] fixing rel ref links that don't work w/ our redirect system --- content/docs/insights/get-started/account-management.md | 2 +- content/docs/insights/get-started/begin.md | 2 +- content/pricing/_index.md | 6 +++--- content/topics/kubernetes.md | 2 +- layouts/product/pulumi-insights.html | 2 +- 5 files changed, 7 insertions(+), 7 deletions(-) diff --git a/content/docs/insights/get-started/account-management.md b/content/docs/insights/get-started/account-management.md index 63ff99f8429d..bdcbb5b16e32 100644 --- a/content/docs/insights/get-started/account-management.md +++ b/content/docs/insights/get-started/account-management.md @@ -27,7 +27,7 @@ For example, AWS enables you to divide you infrastructure into regions and Insig It's important to note that if you **Scan** or **Delete** the `insights-aws-account` account, Pulumi applies this action to all child accounts. -For a detailed explanation and more examples of how child accounts and hierarchies work see the [Insights accounts documentation](/docs/pulumi-cloud/insights/accounts/#account-hierarchies) +For a detailed explanation and more examples of how child accounts and hierarchies work see the [Insights accounts documentation](/docs/insights/accounts/#account-hierarchies) ## Manage Accounts diff --git a/content/docs/insights/get-started/begin.md b/content/docs/insights/get-started/begin.md index 8bdc4117eeb5..73fb4192e38c 100644 --- a/content/docs/insights/get-started/begin.md +++ b/content/docs/insights/get-started/begin.md @@ -178,7 +178,7 @@ This configuration projects the kubeconfig file contents to a temporary file tha The scanner agent does not have access to external binaries (e.g., `aws`, `gcloud`), so kubeconfig files relying on [client-go credential plugins](https://kubernetes.io/docs/reference/access-authn-authz/authentication/#client-go-credential-plugins) are not supported. We recommend creating a service account with the necessary cluster-scoped permissions (**`get`** and **`list`**) and using its token for authentication. {{< /notes >}} -For a detailed guide on configuring ESC credentials for Insights with Kubernetes see the [following documentation](/docs/pulumi-cloud/insights/accounts/#kubernetes-k8s). +For a detailed guide on configuring ESC credentials for Insights with Kubernetes see the [following documentation](/docs/insights/accounts/#kubernetes-k8s). {{% /choosable %}} diff --git a/content/pricing/_index.md b/content/pricing/_index.md index f3d96d02a2cd..cc3b2bb738c6 100644 --- a/content/pricing/_index.md +++ b/content/pricing/_index.md @@ -288,7 +288,7 @@ comparison_table: - header: Pulumi Insights rows: - title: Resource search - link: /docs/pulumi-cloud/insights/search/ + link: /docs/insights/search/ items: - content: _check - content: _check @@ -301,14 +301,14 @@ comparison_table: - content: 10K results - content: 10K results - title: Data export - link: /docs/pulumi-cloud/insights/#data-export + link: /docs/insights/#data-export items: - content: _blank - content: _blank - content: _check - content: _check - title: Property search - link: /docs/pulumi-cloud/insights/search/#property-queries + link: /docs/insights/search/#property-queries items: - content: _blank - content: _blank diff --git a/content/topics/kubernetes.md b/content/topics/kubernetes.md index 76c41444e589..1af66d67b226 100644 --- a/content/topics/kubernetes.md +++ b/content/topics/kubernetes.md @@ -227,7 +227,7 @@ superpowers: - title: Intelligent Cloud Management cta: Learn more - cta_url: "/docs/pulumi-cloud/insights/" + cta_url: "/docs/insights/" icon_type: cloud-with-nodes icon_color: purple description: | diff --git a/layouts/product/pulumi-insights.html b/layouts/product/pulumi-insights.html index 03852a281f03..fd20bd07c893 100644 --- a/layouts/product/pulumi-insights.html +++ b/layouts/product/pulumi-insights.html @@ -12,7 +12,7 @@

{{ .Params.overview.title }}

{{ .Params.overview.body | markdownify }}

- Get Started with Pulumi Insights + Get Started with Pulumi Insights