IoT カスタム Geo マッピング

デフォルトでは、IoT モニタリングはパブリック地理データベースを使用して外部 IP アドレスを地理位置情報に解決します。代わりに、IoT カスタム Geo マッピングを使用して、IoT アプリケーションの地理位置情報に内部 IP アドレスをマッピングすることができます。

カスタム Geo マッピングを使用して、異なる地域に分散された内部アドレスを使用し、仮想プライベートクラウド（VPC）で実行されているデバイスのパフォーマンスをモニタできます。

IP アドレスをマッピングする方法

1 つの IP アドレス、IP アドレスの範囲、またはサブネットマスクを持つ複数の IP アドレスを 1 つの地理位置情報にマッピングできます。これにより、内部 IP アドレスを地理的な場所にマッピングする方法を幅広く制御できます。

カスタム Geo マッピングの範囲

SaaS コントローラでは、カスタム Geo マッピングのみを使用できます。アプリケーションキーごとに 1 つのカスタム Geo マッピングを指定できます。各アプリケーションキーに複数のアプリケーションを含めることができ、アプリケーションがカスタム Geo マッピングを使用できるようになります。

Geo マッピングファイル

Geo マッピングファイルは、IP アドレスを地理位置情報にマッピングするために使用される XML ファイルです。IoT アプリケーションのコントローラに、このファイルをアップロードします。

ファイル仕様

Geo マッピングファイルのサイズは 1 GB に制限されていますが、マッピングされる IP アドレスの数に制限はありません。

デフォルトマッピング

カスタム Geo マッピングファイルをアップロードすると、IoT モニタリングは、マッピングされた IP アドレスと場所に基づいて IP アドレスのみを解決します。したがって、カスタム Geo マッピングファイルを使用する場合は、IP 範囲全体をカバーするようにデフォルトを設定する必要があります。

IPアドレスとその範囲

カスタム Geo マッピングファイルでは、IPv4 アドレスのみを指定できます。

IP アドレスの範囲を使用する場合は、アドレスを昇順でリストする必要があります。たとえば、Geo マッピングファイルで 1.1.1.1 ～ 2.2.2.2 および 2.2.2.2 ～ 3.3.3.3 の 2 つの範囲を指定している場合は、昇順になるように 2 番目の範囲より前に最初の範囲をリストする必要があります。

Geo マッピングファイルの例

次の Geo マッピングファイルの例では、地理位置情報のマッピングの範囲を示し、それぞれに一般的なユースケースを示します。

最も単純な設定では、1 つの IP アドレスを 1 つの地理位置情報にマッピングします。

<mappings>
    <mapping>
        <ip-range from="192.168.123.0" to="192.168.123.0"/>
        <location country="United States" region="California" city="San Jose"/>
    </mapping>
    <default country="United States" region="California" city="San Francisco"/>
</mappings>

XML

1 つの IP アドレスの範囲で 1 つの位置情報を表すことが一般的です。range 属性を使用して、IP アドレスの範囲を指定できます。

<mappings>
    <mapping>
        <ip-range from="192.168.1.1" to="192.168.1.255"/>
            <location country="USA" region="CA" city="Walnut Creek"/>
    </mapping>
    <default country="USA" region="NY" city="New York"/>
</mappings>

XML

IP アドレスの数が限られている場合は、IP サブネットマスクを使用して 1 つの IP アドレスを多数に分割することで、ネットワーク接続を最大化できます。

<mappings>
    <mapping>
        <subnet from="192.168.1.1" mask="255.255.255.0"/>
        <location country="United States" region="California" city="San Francisco"/>
    </mapping>
    <default country="China" region="Zhejiang" city="Hangzhou"/>
</mappings>

XML

Geo マッピングファイルの XML スキーマ

次の XML スキーマファイル custom-geo-mapping.xsd をダウンロードして、Geo マッピング XML ファイルを検証できます。

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<xs:schema version="1.0" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:element name="mappings" type="config"/>
  <xs:element name="ip-range" type="explicitIpAddressRange"/>
  <xs:element name="subnet" type="subnetIpAddressRange"/>
  <xs:complexType name="config">
    <xs:sequence>
      <xs:element name="mapping" type="mapping" minOccurs="0" maxOccurs="unbounded"/>
      <xs:element name="default" type="geoLocation" minOccurs="0" maxOccurs="1"/>
    </xs:sequence>
  </xs:complexType>
  <xs:complexType name="mapping">
    <xs:sequence>
      <xs:choice>
        <xs:element ref="ip-range"/>
        <xs:element ref="subnet"/>
      </xs:choice>
      <xs:element name="location" type="geoLocation" minOccurs="1"/>
    </xs:sequence>
  </xs:complexType>
  <xs:complexType name="geoLocation">
    <xs:attribute name="country" type="xs:string" use="required"/>
    <xs:attribute name="region" type="xs:string" use="required"/>
    <xs:attribute name="city" type="xs:string" use="required"/>
  </xs:complexType>
  <xs:complexType name="explicitIpAddressRange">
      <xs:attribute name="from" type="xs:string" use="required"/>
      <xs:attribute name="to" type="xs:string" use="required"/>
  </xs:complexType>
  <xs:complexType name="subnetIpAddressRange">
      <xs:attribute name="from" type="xs:string" use="required"/>
      <xs:attribute name="mask" type="xs:string" use="required"/>
  </xs:complexType>
</xs:schema>

XML

Geo マッピングファイルのアップロード

SaaS コントローラから、カスタム Geo マッピングファイルを使用して次のアクションを実行できます。

新しい Geo マッピングファイルのアップロード
既存の Geo マップファイルの上書き
Geo マップファイルのリセット

新しい Geo マッピングファイルのアップロード

Configuration > Custom GeoMap に移動します。
[Upload Custom GeoMap file] ダイアログで、[Choose File] をクリックします。
Geo マッピング XML ファイルを選択します。
[Upload] をクリックします。
アップロードが成功すると、次の確認が表示されます。
次のエラーメッセージが表示された場合は、「Geo マップファイルのトラブルシューティング」を参照してください。

Geo マッピングファイルをアップロードした後、IoT モニタリングがアプリケーションに新しいカスタムマッピングを適用するのに少し時間がかかる場合があります。

既存の Geo マップファイルの上書き

Configuration > Custom GeoMap に移動します。
[Upload Custom GeoMap file] ダイアログで、[Overwrite Current Mapping] をクリックします。
Geo マッピング XML ファイルを選択します。
[Upload] をクリックします。
アップロードが成功すると、次の確認が表示されます。
次のエラーメッセージが表示された場合は、「Geo マップファイルのトラブルシューティング」を参照してください。

Geo マップファイルのリセット

Configuration > Custom GeoMap に移動します。
[Upload Custom GeoMap file] ダイアログで、[Reset to Default] をクリックします。
[Reset Confirmation] ダイアログで、[Reset] をクリックします。

カスタム地理位置情報の表示

Geo ウィジェットを 1 つ以上の使用可能なダッシュボードに追加して、デバイスの地理位置情報を表示できます。 Geo ウィジェットは、パブリック地理データベースまたはカスタム IP アドレスマッピングで解決された地理位置情報を表示します。 Device Dashboardから地理位置情報を表示するには、次のようにします。

IoT アプリケーションから [Devices] に移動します。
Geo ウィジェットまでスクロールダウンします。
（オプション）カスタム Geo ウィジェットをビルドします。市区町村、地域、国などの地理データによってデバイスをフィルタ処理できます。

さらに、Geo マッピングファイルに基づく地理データによって、他のウィジェットのデータをフィルタ処理することもできます。

Geo マップファイルのトラブルシューティング

アップロードの問題

カスタム Geo マッピングファイルをアップロードしようとしたときにエラーメッセージが表示された場合は、次のことを確認してください。

XML の有効性：XML 検証ツールを使用して、Geo マッピングファイルの XML が有効かどうかを判断します。
XML スキーマ：カスタム Geo マッピングファイルが XML スキーマに準拠していることを確認します。
無効な IP アドレス：IP アドレスが有効であることを確認します。
ファイルサイズ：カスタム Geo マッピングファイルが 1 GB 未満であることを確認します。

不適切な Geo マッピング

IP アドレスが正しい地理位置情報に解決されていない場合は、Geo マッピングファイル内の IP アドレスと Geo ロケーションが正しいことを確認します。