Web サイトの自動インスツルメンテーション

モニターする Web サイトを作成するには、以下の手順を実行します。

1. Instana のUIで、 「Webサイトとモバイルアプリ」 に移動し、 「Webサイトを追加」 をクリックします。

2. ウェブサイト名を入力し、 「ウェブサイトを追加」 をクリックしてください。

   

3. すべての準備ができています。 reportingUrl、 key、および jsAgentUrlの値を書き留めます。 ステップ2で、 Instana*instanaAgentDir*/etc/instana/configuration.yaml エージェントの設定ファイルにこれらの値を指定する必要があります。

   

Instana*instanaAgentDir*/etc/instana/configuration.yaml エージェントのファイルのうち、 Apache HTTP Server が含まれている箇所を修正してください。 Instanaconfiguration.yaml エージェントのファイルには、Webサイトの自動計測に関する以下の設定項目が用意されています：

#EUM
#com.instana.plugin.eum:
#  instrumentation:
#    #contentTypes:                       # List of the 'Content-Type' values for matching requests that need to be instrumented,
#                                         #  default values in the list are 'text/html' and 'application/xhtml+xml'.
#    #  - 'text/html'
#    #  - 'application/xhtml+xml'
#    #aggressive: false                   # Indicates whether to instrument with the EUM JavaScript agent if Instana cannot determine
#                                         # the 'Content-Type' of the request, default is false.
#    #######################################################################################################
#    # Following parameters are used as common EUM monitoring configuration.
#    # They can be overwritten by specifying them in the website configuration.
#    #######################################################################################################
#    jsAgentUrl: 'https://eum.instana.io/1.7.2/eum.min.js' # EUM JavaScript agent download URL.
#    reportingUrl: <reportingUrl>                    # The URL to which to send website monitoring data to.
#    trackSessions: true                             # Indicates whether to enable session tracking, default is true.
#    autoPageDetection: true                         # Indicates whether to enable automatic page detection for single-page-application, default is true.
#    #######################################################################################################
#    # AutoPageDetection can be further customised to use url RegEx mapping rule or document title as page name.
#    # If the following parameters are enabled the priority of autoPageDetection will be:
#    # RegEx mapping rule > auto detect page title > regular automatic page detection
#    #autoPageDetectionRegex:                        # Indicates whether to match an array of RegExp objects to the URL of page change and replace them with the string provided.
#     #- ['/.*MappingRule.*/i', 'PageTitle String']
#     #- ['/.*aboutPage.*-([A-Za-z].*)/', 'About Page id: $1']
#    #autoPageDetectionPageTitle: false              # Indicates whether to enable document title as page name. Default value is false.
#    #######################################################################################################
#    integrityId: 'sha384-cgeSlevgebehPauohUhsnAeBrpjXzaj94mSv3L2EXjCQH0RRb9xSQ2ErGOWkthIJ' # The SHA value corresponding to the jsAgentUrl version for SRI enablement.
#    #######################################################################################################
#    # Following parameters are used to configure each monitored website.
#    # Optional parameters are commented out by default. Remove the hashtag (#) when needed.
#    #######################################################################################################
#    websites:
#      - name: <WEBSITE_NAME>             # Name of the website for the website configuration in Instana.
#        key: <WEBSITE_KEY>               # Monitoring key for the website configuration in Instana.
#        #enabled: true                   # Indicates whether to enable website monitoring on this website, default is true.
#        #reportingUrl: <reportingUrl>    # The URL to which to send website monitoring data to. Overwrites upper-level setting.
#        #jsAgentUrl: 'https://eum.instana.io/1.7.2/eum.min.js' # JavaScript agent download URL. Overwrites upper-level setting.
#        #trackSessions: true             # Indicates whether to enable session tracking, default is true. Overwrites upper-level setting.
#        #autoPageDetection: true         # Indicates whether to enable automatic page detection for single-page-application, default is true. Overwrites upper-level setting.
#        ##autoPageDetectionRegex:         # Indicates whether to set page title based on a specific RegEx mapping rule in automatic page detection. Overwrites upper-level setting.
#        ## - ['/.*MappingRule.*/i', 'PageTitle']
#        ## - ['/.*aboutPage.*-([A-Za-z].*)/', 'About Page id: $1']
#        ##autoPageDetectionPageTitle: false  # Indicates whether to enable document title as page name. Default value is false. Overwrites upper-level setting.
#        #integrityId: 'sha384-cgeSlevgebehPauohUhsnAeBrpjXzaj94mSv3L2EXjCQH0RRb9xSQ2ErGOWkthIJ' # The SHA value corresponding to the jsAgentUrl version for SRI enablement. Overwrites upper-level setting.
#        #mode: 'regular'                 # Mode for monitoring data transmission, default is 'regular'.
#                                         # Available mode is 'regular'.
#        selector:                        # List of match expressions to filter requests.
#          matchExpressions:              # When all match expressions are evaluated to true, the request is monitored.
#                                         # At least one match expression with the key of the 'url' catalog must be defined.
#            - key: 'url/path'            # Key specified in the <catalog>/<resource> format.
#                                         # Available catalogs in the key include 'url' for request filtering plus
#                                         #  'container' and 'k8s' for Web Server infrastructure filtering.
#                                         # Available keys:
#                                         #  'url/hostname', 'url/path', and 'url/filename'
#                                         #  'container/name' and 'container/imagename'
#                                         #  'k8s/namespace', 'k8s/podname', and 'k8s/containername'
#              operator: 'StartWith'      # Match expression operators: 'Contains', 'ContainsIgnoreCase', 'Equals',
#                                         #  'EqualsIgnoreCase', 'StartWith', and 'StartWithIgnoreCase'.
#              values:                    # List of match expression values.
#                - '/'
 

各行のコメントに従って、EUM Web サイトの自動インスツルメンテーションを構成します。 以下の例を参照してください。

com.instana.plugin.eum:
  instrumentation:
    jsAgentUrl: 'https://eum.instana.io/1.7.2/eum.min.js'
    reportingUrl: 'https://eum.example.com'
    trackSessions: true
    integrityId: 'integrityId for version 1.7.2'
    websites:
      - name: demo
        key: YOURWEBSITEKEYHERE
        selector:
          matchExpressions:
            - key: 'url/hostname'
              operator: 'Equals'
              values:
                - 'example.com'
 

この例では、ホスト名 へのすべての HTTPexample.com リクエストに対して、Webサイトの監視が有効になっています。 生成されたビーコンは、レポート用 YOURWEBSITEKEYHERE キーを添付して、 URL 宛て demo に送信 https://eum.example.comされます。

変更した configuration.yaml ファイルを保存すると、 HTTPd のEUMモジュールが自動的にダウンロードされ、インストールされます。 HTTPdinstana_tracing.conf の設定ディレクトリにあるファイルを確認することで、モジュールを検証できます。

HTTPd のトレース設定で true が に設定されている autoRestart 場合、 Apache HTTP Server を手動で再起動する必要はありません。

com.instana.plugin.httpd:
  tracing:
    autoRestart: true
 

それ以外の場合は、 Apache HTTP Server を正常に再起動して、EUMモジュールを読み込んでください。

ワークロードがウェブサイトに存在することを確認してください。 Go Instana のUIにあるWebサイトのダッシュボードにアクセスし、監視データが正常に受信されていることを確認してください。

以下の例は、 Apache HTTPd の設定に複数の VirtualHost が存在する場合に、Webサイトが自動的に計測対象となるよう、マッチ式を定義する方法を示しています。

例えば、以下の VirtualHost 定義を参照してください。

Listen 80
<VirtualHost *:80>
    DocumentRoot "/www/example1"
    ServerName www.example.com

    # Other directives here
</VirtualHost>

<VirtualHost *:80>
    DocumentRoot "/www/example2"
    ServerName www.example.org

    # Other directives here
</VirtualHost>
 

以下の例は、特定のインフラストラクチャ展開上のWebサイトが自動的に計測対象となるよう、マッチ式を定義する方法を示しています。