Add troubleshooting setup guide link to enterprise search instructions page (#127820)

packages/kbn-doc-links/src/get_doc_links.ts

@@ -109,6 +109,7 @@ export const getDocLinks = ({ kibanaBranch }: GetDocLinkOptions): DocLinks => {
       configuration: `${ENTERPRISE_SEARCH_DOCS}configuration.html`,
       licenseManagement: `${ENTERPRISE_SEARCH_DOCS}license-management.html`,
       mailService: `${ENTERPRISE_SEARCH_DOCS}mailer-configuration.html`,
+      troubleshootSetup: `${ENTERPRISE_SEARCH_DOCS}troubleshoot-setup.html`,
       usersAccess: `${ENTERPRISE_SEARCH_DOCS}users-access.html`,
     },
     workplaceSearch: {

packages/kbn-doc-links/src/types.ts

@@ -99,6 +99,7 @@ export interface DocLinks {
     readonly configuration: string;
     readonly licenseManagement: string;
     readonly mailService: string;
+    readonly troubleshootSetup: string;
     readonly usersAccess: string;
   };
   readonly workplaceSearch: {

x-pack/plugins/enterprise_search/public/applications/shared/doc_links/doc_links.ts

@@ -32,6 +32,7 @@ class DocLinks {
   public cloudIndexManagement: string;
   public enterpriseSearchConfig: string;
   public enterpriseSearchMailService: string;
+  public enterpriseSearchTroubleshootSetup: string;
   public enterpriseSearchUsersAccess: string;
   public kibanaSecurity: string;
   public licenseManagement: string;
@@ -86,6 +87,7 @@ class DocLinks {
     this.cloudIndexManagement = '';
     this.enterpriseSearchConfig = '';
     this.enterpriseSearchMailService = '';
+    this.enterpriseSearchTroubleshootSetup = '';
     this.enterpriseSearchUsersAccess = '';
     this.kibanaSecurity = '';
     this.licenseManagement = '';
@@ -141,6 +143,7 @@ class DocLinks {
     this.cloudIndexManagement = docLinks.links.cloud.indexManagement;
     this.enterpriseSearchConfig = docLinks.links.enterpriseSearch.configuration;
     this.enterpriseSearchMailService = docLinks.links.enterpriseSearch.mailService;
+    this.enterpriseSearchTroubleshootSetup = docLinks.links.enterpriseSearch.troubleshootSetup;
     this.enterpriseSearchUsersAccess = docLinks.links.enterpriseSearch.usersAccess;
     this.kibanaSecurity = docLinks.links.kibana.xpackSecurity;
     this.licenseManagement = docLinks.links.enterpriseSearch.licenseManagement;

x-pack/plugins/enterprise_search/public/applications/shared/setup_guide/cloud/instructions.tsx

@@ -135,6 +135,37 @@ export const CloudSetupInstructions: React.FC<Props> = ({ productName, cloudDepl
             </EuiCallOut>
           ),
         },
+        {
+          title: i18n.translate('xpack.enterpriseSearch.setupGuide.cloud.step6.title', {
+            defaultMessage: 'Troubleshooting issues',
+          }),
+          children: (
+            <>
+              <EuiText>
+                <p>
+                  <FormattedMessage
+                    id="xpack.enterpriseSearch.setupGuide.cloud.step6.instruction1"
+                    defaultMessage="For help with common setup issues, read our {link} guide."
+                    values={{
+                      link: (
+                        <EuiLink
+                          href={docLinks.enterpriseSearchTroubleshootSetup}
+                          target="_blank"
+                          external
+                        >
+                          {i18n.translate(
+                            'xpack.enterpriseSearch.setupGuide.cloud.step6.instruction1LinkText',
+                            { defaultMessage: 'Troubleshoot Enterprise Search setup' }
+                          )}
+                        </EuiLink>
+                      ),
+                    }}
+                  />
+                </p>
+              </EuiText>
+            </>
+          ),
+        },
       ]}
     />
   </EuiPageContent>

x-pack/plugins/enterprise_search/public/applications/shared/setup_guide/instructions.tsx

@@ -14,10 +14,14 @@ import {
   EuiCode,
   EuiCodeBlock,
   EuiAccordion,
+  EuiLink,
+  EuiSpacer,
 } from '@elastic/eui';
 import { i18n } from '@kbn/i18n';
 import { FormattedMessage } from '@kbn/i18n-react';
 
+import { docLinks } from '../doc_links';
+
 interface Props {
   productName: string;
 }
@@ -94,6 +98,29 @@ export const SetupInstructions: React.FC<Props> = ({ productName }) => (
                   </p>
                 </EuiText>
               </EuiAccordion>
+              <EuiSpacer />
+              <EuiText>
+                <p>
+                  <FormattedMessage
+                    id="xpack.enterpriseSearch.troubleshooting.setup.description"
+                    defaultMessage="For help with other common setup issues, read our {link} guide."
+                    values={{
+                      link: (
+                        <EuiLink
+                          href={docLinks.enterpriseSearchTroubleshootSetup}
+                          target="_blank"
+                          external
+                        >
+                          {i18n.translate(
+                            'xpack.enterpriseSearch.troubleshooting.setup.documentationLinkLabel',
+                            { defaultMessage: 'Troubleshoot Enterprise Search setup' }
+                          )}
+                        </EuiLink>
+                      ),
+                    }}
+                  />
+                </p>
+              </EuiText>
             </>
           ),
         },