Soracom

Users

ドキュメント
Home ドキュメント SORACOM Funnel はじめに

SORACOM Funnel の特徴

Funnel の特徴は以下のとおりです。

  • デバイスからはシンプルなプロトコルでデータを送信できます。通常クラウドサービスを利用する際には SDK などをデバイスにインストールする必要がある場合が多くありますが、Funnel を利用すれば、HTTP や TCP などを使用してデータを送信できます。

  • クラウドサービスの接続先や認証情報をデバイスに保管する必要がありません。ユーザーコンソールや API から簡単に変更できます。

  • 主要なクラウドベンダーのサービスに対応しています。

  • SORACOM パートナースペースの認定済パートナー が提供する各種ソリューションにも対応しています。

  • Funnel では非同期に転送先へデータが送信されます。

    Funnel はその設計ポリシーとしてスケーラビリティを最重要視しており、デバイスからの各リクエストは一旦 SORACOM でバッファリングされ、非同期に各サービスへデータを送信する仕組みとなっています。そのため、クラウドサービスからレスポンスを返すことはできず、データ処理が成功したか 失敗したかをデバイスが直接知ることもできません (失敗時にはエラーログが記録されます)。

    送信されたデータの処理結果をすぐに知りたい場合や、デバイス自体が再送を行いたい場合には、Beam の利用も検討してください。

HTTP/TCP/UDP セッションは切断されることがあります

SORACOM のメンテナンスに伴い、任意のタイミングで HTTP/TCP/UDP セッションが切断される場合があります。メンテナンスに伴うセッション切断は、SORACOM Status Dashboard などで告知されません。ご了承ください。

AWS STS エンドポイントをアクティブ化してください

Funnel の以下のアダプターを使用する場合は、AWS が提供する AWS STS エンドポイントをアクティブ化してください。

  • AWS IoT アダプター
  • Amazon Data Firehose アダプター
  • Amazon Kinesis Data Streams アダプター

なお、アクティブ化する AWS STS エンドポイントは、Funnel のカバレッジタイプによって異なります。

SORACOM のカバレッジタイプAWS リージョンAWS STS エンドポイント
グローバルカバレッジ欧州 (フランクフルト) eu-central-1sts.eu-central-1.amazonaws.com
日本カバレッジアジアパシフィック (東京) ap-northeast-1sts.ap-northeast-1.amazonaws.com

たとえば、日本カバレッジで Funnel の AWS IoT アダプターを利用する場合は、sts.ap-northeast-1.amazonaws.com をアクティブ化します。

AWS STS エンドポイントのアクティブ化について詳しくは、AWS リージョン での AWS STS のアクティブ化と非アクティブ化 を参照してください。

Funnel を使って短い間隔 (1 秒に 1 リクエスト等) でデータ送信することを検討されているお客様は、セールスチーム にお問い合わせください。

整数データへ変換される制限は無くなりました

2021 年 8 月 3 日以降、小数点以下がすべて 0 のデータ (例: {"temperature": 20.0}) をクラウドサービスに送信するときに、小数点 1 桁目の 0 が維持されるようになりました。 たとえば、{"temperature": 20.0} をデバイスから送信すると、SORACOM Funnel で整数データに変換されることなく、{"temperature": 20.0} のままクラウドサービスに送信されます。

ただし、{"temperature": 20.00} を送信すると、小数点 1 桁目の 0 のみが維持され、{"temperature": 20.0} が送信されます。

データ送信サイズ

最大データ送信サイズは以下のとおりです。

  • HTTP: 約 780 KB (800000 バイト)
  • TCP: 64 KB (64 KB のデータを送信するには、SORACOM Binary Format v1 の利用が必要です)
  • UDP: 1 つの UDP データグラムで送信できるペイロード長