Steuern des Zugriffs auf Dashboards OpenSearch Konfiguration von OpenSearch Dashboards für die Verwendung eines WMS-Kartenservers Einen lokalen Dashboards-Server mit dem Service verbinden OpenSearch Indizes in Dashboards verwalten OpenSearch Weitere Features

Verwenden von OpenSearch Dashboards mit Amazon Service OpenSearch

OpenSearch Dashboards ist ein Open-Source-Visualisierungstool, mit dem Sie arbeiten können. OpenSearch Amazon OpenSearch Service bietet für jede OpenSearch Service-Domain eine Installation von OpenSearch Dashboards. OpenSearch Dashboards wird auf den Hot-Data-Knoten in der Domain ausgeführt.

In Ihrem Domain-Dashboard in der OpenSearch Servicekonsole finden Sie einen Link zu OpenSearch Dashboards. Für laufende OpenSearch Domains lautet domain-endpoint/_dashboards/ die URL. Für Domains, auf denen Legacy-Elasticsearch ausgeführt wird, lautet domain-endpoint/_plugin/kibana die URL.

Abfragen, die diese OpenSearch Standard-Dashboards-Installation verwenden, haben ein Timeout von 300 Sekunden.

Anmerkung

In dieser Dokumentation werden OpenSearch Dashboards im Kontext von Amazon OpenSearch Service beschrieben, einschließlich verschiedener Verbindungsmöglichkeiten. Eine umfassende Dokumentation, einschließlich eines Leitfadens für die ersten Schritte, einer Anleitung zum Erstellen eines Dashboards, der Verwaltung von Dashboards und der Dashboards Query Language (DQL), finden Sie unter OpenSearch Dashboards in der Open-Source-Dokumentation. OpenSearch

In den folgenden Abschnitten werden einige gängige Anwendungsfälle für Dashboards behandelt: OpenSearch

Steuern des Zugriffs auf Dashboards OpenSearch
Konfiguration von OpenSearch Dashboards für die Verwendung eines WMS-Kartenservers
Einen lokalen Dashboards-Server mit dem Service verbinden OpenSearch

Steuern des Zugriffs auf Dashboards OpenSearch

Dashboards unterstützt IAM-Benutzer und -Rollen nicht nativ, aber OpenSearch Service bietet mehrere Lösungen für die Steuerung des Zugriffs auf Dashboards:

Aktivieren Sie die SAML-Authentifizierung für Dashboards.
Verwenden Sie eine differenzierte Zugriffskontrolle mit HTTP-Basisauthentifizierung.
Konfiguration Cognito-Authentifizierung für Dashboards.
Konfigurieren Sie für öffentliche Zugriff-Domains eine IP-basierte Zugriffsrichtlinie, mit oder ohne Proxy-Server.
Verwenden Sie für VPC-Zugriff-Domains eine offene Zugriffsrichtlinie mit oder ohne Proxyserver und Sicherheitsgruppen, um den Zugriff zu steuern. Weitere Informationen hierzu finden Sie unter Zugriffsrichtlinien für VPC-Domänen.

Verwenden eines Proxys für den Zugriff auf den Service über Dashboards OpenSearch OpenSearch

Anmerkung

Dieses Verfahren ist nur anwendbar, wenn Ihre Domain einen öffentlichen Zugriff verwendet und Sie die Cognito-Authentifizierung nicht verwenden möchten. Siehe Steuern des Zugriffs auf Dashboards OpenSearch .

Da es sich bei Dashboards um eine JavaScript Anwendung handelt, stammen Anfragen von der IP-Adresse des Benutzers. Eine IP-basierte Zugriffskontrolle ist möglicherweise wegen der hohen Anzahl von IP-Adressen unpraktisch, die Sie erlaubt haben müssten, um jedem Benutzer Zugriff auf Dashboards zu gewähren. Eine Problemumgehung besteht darin, einen Proxyserver zwischen OpenSearch Dashboards und Service zu platzieren. OpenSearch Anschließend können Sie eine IP-basierte Zugriffsrichtlinie hinzufügen, mit der Anforderungen von nur einer IP-Adresse möglich sind: der Adresse des Proxys. In der folgenden Abbildung ist diese Konfiguration dargestellt.

Dies ist Ihre OpenSearch Service-Domain. IAM bietet autorisierten Zugriff auf diese Domain. Eine zusätzliche, IP-basierte Zugriffsrichtlinie bietet Zugriff auf den Proxy-Server.
Dies ist der Proxy-Server, der auf einer Amazon-EC2-Instance ausgeführt wird.
Andere Anwendungen können den Signaturprozess von Signature Version 4 verwenden, um authentifizierte Anfragen an den OpenSearch Service zu senden.
OpenSearch Dashboard-Clients stellen über den Proxy eine Verbindung zu Ihrer OpenSearch Service-Domain her.

Wenn Sie diese Art von Konfiguration aktivieren möchten, benötigen Sie eine ressourcenbasierte Richtlinie, in der Rollen und IP-Adressen angegeben sind. Hier sehen Sie ein Beispiel für eine Richtlinie:


{
   "Version":"2012-10-17",
   "Statement":[
      {
         "Resource":"arn:aws:es:us-west-2:111111111111:domain/my-domain/*",
         "Principal":{
            "AWS":"arn:aws:iam::111111111111:role/allowedrole1"
         },
         "Action":[
            "es:ESHttpGet"
         ],
         "Effect":"Allow"
      },
      {
         "Effect":"Allow",
         "Principal":{
            "AWS":"*"
         },
         "Action":"es:*",
         "Condition":{
            "IpAddress":{
               "aws:SourceIp":[
                  "203.0.113.0/24",
                  "2001:DB8:1234:5678::/64"
               ]
            }
         },
         "Resource":"arn:aws:es:us-west-2:111111111111:domain/my-domain/*"
      }
   ]
}

Wir empfehlen, dass Sie die EC2 Instance, auf der der Proxy-Server ausgeführt wird, mit einer Elastic IP-Adresse konfigurieren. Auf diese Weise können Sie die Instance bei Bedarf ersetzen und weiterhin dieselbe öffentliche IP-Adresse an sie anfügen. Weitere Informationen finden Sie unter Elastic IP Addresses im Amazon EC2 EC2-Benutzerhandbuch.

Wenn Sie einen Proxy-Server und die Cognito-Authentifizierung, verwenden, müssen Sie möglicherweise Einstellungen für Dashboards und Amazon Cognito hinzufügen, um redirect_mismatch-Fehler zu vermeiden. Sehen Sie sich das folgende nginx.conf-Beispiel an:


server {
    listen 443;
    server_name $host;
    rewrite ^/$ https://$host/_plugin/_dashboards redirect;

    ssl_certificate           /etc/nginx/cert.crt;
    ssl_certificate_key       /etc/nginx/cert.key;

    ssl on;
    ssl_session_cache  builtin:1000  shared:SSL:10m;
    ssl_protocols  TLSv1 TLSv1.1 TLSv1.2;
    ssl_ciphers HIGH:!aNULL:!eNULL:!EXPORT:!CAMELLIA:!DES:!MD5:!PSK:!RC4;
    ssl_prefer_server_ciphers on;

    location /_plugin/_dashboards {
        # Forward requests to Dashboards
        proxy_pass https://$dashboards_host/_plugin/_dashboards;

        # Handle redirects to Cognito
        proxy_redirect https://$cognito_host https://$host;

        # Update cookie domain and path
        proxy_cookie_domain $dashboards_host $host;
        proxy_cookie_path / /_plugin/_dashboards/;

        # Response buffer settings
        proxy_buffer_size 128k;
        proxy_buffers 4 256k;
        proxy_busy_buffers_size 256k;
    }

    location ~ \/(log|sign|fav|forgot|change|saml|oauth2) {
        # Forward requests to Cognito
        proxy_pass https://$cognito_host;

        # Handle redirects to Dashboards
        proxy_redirect https://$dashboards_host https://$host;

        # Update cookie domain
        proxy_cookie_domain $cognito_host $host;
    }
}

Konfiguration von OpenSearch Dashboards für die Verwendung eines WMS-Kartenservers

Die Standardinstallation von OpenSearch Dashboards for OpenSearch Service umfasst einen Kartenservice, mit Ausnahme von Domains in den Regionen Indien und China. Der Karten-Service unterstützt bis zu 10 Zoomstufen.

Unabhängig von Ihrer Region können Sie Dashboards so konfigurieren, dass ein anderer Web-Map-Server (WMS)-Server für Koordinatenkartenvisualisierungen verwendet wird. Regionskartenvisualisierungen unterstützen nur den Standardkarten-Service.

So konfigurieren Sie Dashboards für die Verwendung eines WMS-Map-Servers:

Öffnen von Dashboards
Klicken Sie auf Verwaltung von Stack.
Wählen Sie Advanced settings (Erweiterte Einstellungen) aus.
Suchen Sie visualization:tileMap:WMSdefaults.

Ändern Sie enabled zu true und url zur URL eines gültigen WMS Map-Servers.


{
  "enabled": true,
  "url": "wms-server-url",
  "options": {
    "format": "image/png",
    "transparent": true
  }
}

Wählen Sie Änderungen speichern aus.

Um den neuen Standardwert auf Visualisierungen anzuwenden, müssen Sie möglicherweise Dashboards erneut laden. Wenn Sie Visualisierungen gespeichert haben, wählen Sie Options (Optionen), nachdem Sie die Visualisierung geöffnet haben. Stellen Sie sicher, dass der WMS Map Server aktiviert ist und die WMS-URL den bevorzugten Map-Server enthält, und wählen Sie dann Apply changes (Änderungen übernehmen) aus.

Anmerkung

Map-Services erheben häufig Lizenzgebühren oder schränken die Nutzung ein. Sie sind für all diese Aspekte des Map-Servers verantwortlich, den Sie angeben. Map-Services des U.S. Geological Survey (Geologisches Amt der USA) können zum Testen nützlich sein.

Einen lokalen Dashboards-Server mit dem Service verbinden OpenSearch

Wenn Sie bereits viel Zeit in die Konfiguration Ihrer eigenen OpenSearch Dashboards-Instanz investiert haben, können Sie diese anstelle der von Service bereitgestellten Standard-Dashboards-Instanz (oder zusätzlich zu) verwenden. OpenSearch Das folgende Verfahren funktioniert für Domains, die eine differenzierte Zugriffskontrolle mit einer offenen Zugriffsrichtlinie verwenden.

Um einen lokalen OpenSearch Dashboards-Server mit Service zu verbinden OpenSearch

Erstellen Sie in Ihrer OpenSearch Service-Domain einen Benutzer mit den entsprechenden Berechtigungen:
1. Wechseln Sie in Dashboards zu Sicherheit, Interne Benutzer und wählen Sie Erstellen eines internen Benutzers aus.
2. Geben Sie einen Benutzernamen und ein Passwort ein und wählen Sie Erstellen aus.
3. Wechseln Sie zu Rollen und wählen Sie eine Rolle aus.
4. Wählen Sie Zugeordnete Benutzer aus, und wählen Sie Mapping verwalten aus.
5. Fügen Sie unter Benutzer Ihren Benutzernamen hinzu und wählen Sie Mapping aus.
Laden Sie die entsprechende Version des OpenSearch Sicherheits-Plug-ins herunter und installieren Sie sie auf Ihrer selbstverwalteten Dashboards OSS-Installation.

Öffnen Sie die config/opensearch_dashboards.yml Datei auf Ihrem lokalen Dashboards-Server und fügen Sie Ihren OpenSearch Service-Endpunkt mit dem zuvor erstellten Benutzernamen und Passwort hinzu:


opensearch.hosts: ['https://domain-endpoint']
opensearch.username: 'username'
opensearch.password: 'password'

Verwenden Sie die folgende opensearch_dashboards.yml-Beispieldatei:


server.host: '0.0.0.0'

opensearch.hosts: ['https://domain-endpoint']

opensearchDashboards.index: ".username"

opensearch.ssl.verificationMode: none # if not using HTTPS

opensearch_security.auth.type: basicauth
opensearch_security.auth.anonymous_auth_enabled: false
opensearch_security.cookie.secure: false # set to true when using HTTPS
opensearch_security.cookie.ttl: 3600000
opensearch_security.session.ttl: 3600000
opensearch_security.session.keepalive: false
opensearch_security.multitenancy.enabled: false
opensearch_security.readonly_mode.roles: ['opensearch_dashboards_read_only']
opensearch_security.auth.unauthenticated_routes: []
opensearch_security.basicauth.login.title: 'Please log in using your username and password'

opensearch.username: 'username'
opensearch.password: 'password'
opensearch.requestHeadersWhitelist: [authorization, securitytenant, security_tenant]

Um Ihre OpenSearch Service-Indizes zu sehen, starten Sie Ihren lokalen Dashboards-Server, gehen Sie zu Dev Tools und führen Sie den folgenden Befehl aus:


GET _cat/indices

Indizes in Dashboards verwalten OpenSearch

Die OpenSearch Dashboards-Installation auf Ihrer OpenSearch Service-Domain bietet eine nützliche Benutzeroberfläche für die Verwaltung von Indizes in verschiedenen Speicherebenen Ihrer Domain. Wählen Sie im Hauptmenü der Dashboards die Option Indexverwaltung aus, UltraWarmum alle Indizes im Hot- und Cold-Storage sowie Indizes, die durch Index State Management (ISM) -Richtlinien verwaltet werden, anzuzeigen. Verwenden Sie die Indexverwaltung, um Indizes zwischen Warm- und Cold-Speicher zu verschieben und Migrationen zwischen den drei Ebenen zu überwachen.

Beachten Sie, dass die Indexoptionen „Heiß“, „Warm“ und „Kalter Speicher“ nicht angezeigt werden, es sei denn, Sie haben UltraWarm und/oder Kaltspeicher aktiviert.

Weitere Features

Die Standardinstallation von OpenSearch Dashboards auf jeder OpenSearch Service-Domain bietet einige zusätzliche Funktionen:

Benutzeroberflächen für die verschiedenen Plugins OpenSearch
Mandanten
Berichte

Verwenden Sie das Menü Berichterstellung, um CSV-Berichte on demand von der Entdecken-Seite und PDF- oder PNG-Berichte von Dashboards oder Visualisierungen zu generieren. CSV-Berichte haben eine Begrenzung von 10.000 Zeilen.
Gantt-Diagramme
Notebooks

Warnung JavaScript ist in Ihrem Browser nicht verfügbar oder deaktiviert.

Zur Nutzung der AWS-Dokumentation muss JavaScript aktiviert sein. Weitere Informationen finden auf den Hilfe-Seiten Ihres Browsers.

Dokumentkonventionen

Generierung von Abfragen in natürlicher Sprache

Verwalten von Indexen