Module # – <module title>

Size: px

Start display at page:

Download "Module # – <module title>"

れいがいせき
5 years ago
Views:

1 IBM Worklight Foundation V6.2.0 入門リモート制御のクライアントサイドログ収集 2014 年 6 月 20 日

2 商標 IBM IBM ロゴおよび ibm.com は世界の多くの国で登録された International Business Machines Corporation. の商標です Worklight は IBM 社の Worklight の商標です他の製品名およびサービス名等はそれぞれ IBM または各社の商標である場合があります現時点での IBM の商標リストについてはをご覧ください Adobe Adobe ロゴ PostScript PostScript ロゴは Adobe Systems Incorporated の米国およびその他の国における登録商標または商標です IT Infrastructure Library は英国 Office of Government Commerce の一部である the Central Computer and Telecommunications Agency の登録商標ですインテル Intel Intel ロゴ Intel Inside Intel Inside ロゴ Centrino Intel Centrino ロゴ Celeron Xeon Intel SpeedStep Itanium および Pentium は Intel Corporation または子会社の米国およびその他の国における商標または登録商標です Linux は Linus Torvalds の米国およびその他の国における登録商標です Microsoft Windows Windows NT および Windows ロゴは Microsoft Corporation の米国およびその他の国における商標です ITIL は英国 The Minister for the Cabinet Office の登録商標および共同体登録商標であって米国特許商標庁にて登録されています UNIX は The Open Group の米国およびその他の国における登録商標です Java およびすべての Java 関連の商標およびロゴは Oracle やその関連会社の米国およびその他の国における商標または登録商標です Cell Broadband Engine は Sony Computer Entertainment, Inc. の米国およびその他の国における商標であり同社の許諾を受けて使用しています Linear Tape-Open LTO LTO ロゴ Ultrium および Ultrium ロゴは HP IBM Corp. および Quantum の米国およびその他の国における商標ですこの資料は事前に IBM の書面による許可を得ずにその一部または全部を複製することは禁じられています IBM についてを参照してください 2

3 アジェンダロギングとはログキャプチャーとその使用法とはサーバーの準備クライアントログキャプチャーの管理者による制御異常終了キャプチャーとその機能とは 3

4 ロギングとは (1/4) 診断およびデバッグを容易にするためにメッセージを記録する API 呼び出しが含まれたソースコードの装備例 : Java の java.util.logging ロギングライブラリーには通常詳細度制御 ( 多くの場合レベルと呼ばれる ) があります例えば詳細度の低い順に ERROR WARN INFO LOG DEBUG 開発者はログビューアーでレベルによるフィルタリングを行うことができますキャプチャーツールは構成でレベルによるフィルタリングを行うことができます 4

5 Worklight でのロギング (Android ネイティブ (Java)) (2/4) 以下の例のように Android Java ネイティブコードを装備します import com.worklight.common.logger; public class MathUtils { private static final Logger logger = Logger.getInstance(MathUtils.class.getName()); public int sum(final int a, final int b) { int sum = a + b; logger.debug("sum called with args " + a + " and " + b + ". Returning " + sum); } } return sum; LogCat に出力します Android Worklight SDK は com.worklight.common.logger.setcontext(context) メソッドが呼び出されるまでログデータを永続的にキャプチャーできません 5

6 Worklight でのロギング (ios ネイティブ (Objective-C)) (3/4) 以下の例のように ios Objective-C ネイティブコードを装備します #import "OCLoggerMacros.h" #import "OCLogger+Constants.h" + (int) sum:(int)a with:(int) b { int sum = a + b; called with args %d and %d. Returning %d", a, b, sum); } return sum; Xcode コンソールに出力します 6

7 Worklight のロギング (JavaScript) (4/4) 以下の例のように JavaScript コードを装備します var MathUtils = function() { var logger = WL.Logger.create({pkg: 'MathUtils'}); var sum = function(a, b) { var sum = a + b; logger.debug('sum called with args ' + a + ' and ' + b + '. Returning ' + sum); return sum; }; }(); ブラウザーの JavaScript コンソール LogCat または Xcode コンソールに出力します 7

8 アジェンダロギングとはログキャプチャーとその使用法とはサーバーの準備クライアントログキャプチャーの管理者による制御異常終了キャプチャーとその機能とは 8

9 ログキャプチャーとその使用法とはロギング API に渡されたメッセージを永続的に記録する機能デフォルトではキャプチャーはオンです以下の API 呼び出しによりキャプチャーをオンまたはオフにします Logger.setCapture(boolean) OCLogger.setCapture(boolean) WL.Logger.config({capture: boolean}) デフォルトは開発環境では DEBUG レベル実稼働環境では FATAL です以下の API 呼び出しによりレベル ( 詳細度 ) を制御します Logger.setLevel(LEVEL) OCLogger.setLevel(NSString) WL.Logger.config({level: string}) 9

10 アジェンダロギングとはログキャプチャーとその使用法とはサーバーの準備クライアントログキャプチャーの管理者による制御異常終了キャプチャーとその機能とは 10

11 サーバー準備 (1/2) 実稼働環境のブラウザーおよびデバイスで永続的にキャプチャーされたログ出力はキャプチャーしたデータを診断検査用に送信できなければ役に立つことはありませんクライアントは累積されたキャプチャー済みログメッセージを以下のタイミングで自動的に送信します Worklight クライアントの接続成功時 Worklight アダプターの呼び出し成功時以下により自動動作をオンまたはオフにします Logger.setAutoSendLogs(boolean) OCLogger.setAutoSendLogs(boolean) WL.Logger.config({autoSendLogs: boolean}) アプリケーションでの明示的な send メソッドの呼び出し 11

12 サーバー準備 ( 実動 ) (2/2) サーバーでログを受信し受信したログを処理する方法は Analytics Platform ( および Worklight Console の Analytics Dashboard リンク ) はデフォルトで (Worklight Studio 開発環境の ) 組み込みの Liberty サーバーにインストールされて使用可能になります (Worklight 実稼働環境の ) サーバーでログを受信し受信したログを処理するには以下の 2 つのオプションがあります Analytics Platform WAR ファイルをインストールする WLClientLogReceiver という名前のアダプター (log という関数 ( プロシージャー ) を持つ ) を開発してデプロイする注 : Analytics Platform のインストールと構成およびアダプターの開発はこの入門ガイドの範囲外です詳しくは関連する入門モジュールまたは IBM Worklight Foundation ユーザー文書を参照してください 12

13 アジェンダロギングとはログキャプチャーとその使用法とはサーバーの準備クライアントログキャプチャーの管理者による制御異常終了キャプチャーとその機能とは 13

14 クライアントログキャプチャーの管理者による制御 (1/2) 実稼働環境のアプリケーションのログキャプチャー設定を構成するには Worklight Console を使用します 14

15 クライアントログキャプチャーの管理者による制御 (2/2) 管理者は Worklight Console から Worklight クライアント SDK ログキャプチャーおよびレベルを制御できますクライアントは以下のタイミングで構成を自動的に取得します Worklight クライアントの接続成功時 Worklight アダプターの呼び出し成功時以下により自動動作をオンまたはオフにします Logger.setAutoUpdateConfig(boolean) OCLogger.setAutoUpdateConfig(boolean) WL.Logger.config({autoUpdateConfig: boolean}) アプリケーションでの明示的な updateconfigfromserver メソッドの呼び出し 15

16 アジェンダロギングとはログキャプチャーとその使用法とはサーバーの準備クライアントログキャプチャーの管理者による制御異常終了キャプチャーとその機能とは 16

17 異常終了キャプチャーとその機能とは異常終了キャプチャーとは Android および ios で Worklight クライアント SDK はアプリケーションの異常終了時にスタックトレースをキャプチャーし FATAL レベルでログに記録しますこのタイプの異常終了は UI がユーザーに表示されなくなる真の異常終了です JavaScript では Worklight クライアント SDK は JavaScript グローバルエラーおよび JavaScript 呼び出しスタック ( 可能な場合 ) をキャプチャーし FATAL レベルでログに記録しますこのタイプの異常終了は異常終了イベントではなく実行時のユーザーエクスペリエンスに悪影響が出ることも出ないこともあります HTTP アダプターを使用するための準備異常終了キャッチされていない例外およびグローバルエラーが自動的にキャッチされてログに記録されます 17

18 詳細情報ロギングおよびログキャプチャーについて詳しくは以下の IBM Worklight Foundation ユーザー文書を参照してください evref/c_client-side_log_capture.html 18

19 特記事項これらの資料は以下のご使用条件に同意していただける場合に限りご使用いただけます本書は米国 IBM が提供する製品およびサービスについて作成したものです本書に記載の製品サービスまたは機能が日本においては提供されていない場合があります日本で利用可能な製品サービスおよび機能については日本 IBM の営業担当員にお尋ねください本書で IBM 製品プログラムまたはサービスに言及していてもその IBM 製品プログラムまたはサービスのみが使用可能であることを意味するものではありませんこれらに代えて IBM の知的所有権を侵害することのない機能的に同等の製品プログラムまたはサービスを使用することができますただし IBM 以外の製品とプログラムの操作またはサービスの評価および検証はお客様の責任で行っていただきます IBM は本書に記載されている内容に関して特許権 ( 特許出願中のものを含む ) を保有している場合があります本書の提供はお客様にこれらの特許権について実施権を許諾することを意味するものではありません実施権についてのお問い合わせは書面にて下記宛先にお送りください東京都中央区日本橋箱崎町 19 番 21 号日本アイビーエム株式会社法務知的財産知的財産権ライセンス渉外以下の保証は国または地域の法律に沿わない場合は適用されません IBM およびその直接または間接の子会社は本書を特定物として現存するままの状態で提供し商品性の保証特定目的適合性の保証および法律上の瑕疵担保責任を含むすべての明示もしくは黙示の保証責任を負わないものとします国または地域によっては法律の強行規定により保証責任の制限が禁じられる場合強行規定の制限を受けるものとしますこの情報には技術的に不適切な記述や誤植を含む場合があります本書は定期的に見直され必要な変更は本書の次版に組み込まれます IBM は予告なしに随時この文書に記載されている製品またはプログラムに対して改良または変更を行うことがあります本書において IBM 以外の Web サイトに言及している場合がありますが便宜のため記載しただけであり決してそれらの Web サイトを推奨するものではありませんそれらの Web サイトにある資料はこの IBM 製品の資料の一部ではありませんそれらの Web サイトはお客様の責任でご使用ください IBM はお客様が提供するいかなる情報もお客様に対してなんら義務も負うことのない自ら適切と信ずる方法で使用もしくは配布することができるものとします本プログラムのライセンス保持者で (i) 独自に作成したプログラムとその他のプログラム ( 本プログラムを含む ) との間での情報交換および (ii) 交換された情報の相互利用を可能にすることを目的として本プログラムに関する情報を必要とする方は下記に連絡してください IBM Corporation Dept F6, Bldg Route 100 Somers NY USA 本プログラムに関する上記の情報は適切な使用条件の下で使用することができますが有償の場合もあります本書で説明されているライセンスプログラムまたはその他のライセンス資料は IBM 所定のプログラム契約の契約条項 IBM プログラムのご使用条件またはそれと同等の条項に基づいて IBM より提供されます IBM 以外の製品に関する情報はその製品の供給者出版物もしくはその他の公に利用可能なソースから入手したものです IBM はそれらの製品のテストは行っておりませんしたがって他社製品に関する実行性互換性またはその他の要求については確証できません IBM 以外の製品の性能に関する質問はそれらの製品の供給者にお願いします著作権使用許諾 : 本書には様々なオペレーティングプラットフォームでのプログラミング手法を例示するサンプルアプリケーションプログラムがソース言語で掲載されていますお客様はサンプルプログラムが書かれているオペレーティングプラットフォームのアプリケーションプログラミングインターフェースに準拠したアプリケーションプログラムの開発使用販売配布を目的としていかなる形式においても IBM に対価を支払うことなくこれを複製し改変し配布することができますこのサンプルプログラムはあらゆる条件下における完全なテストを経ていません従って IBM はこれらのサンプルプログラムについて信頼性利便性もしくは機能性があることをほのめかしたり保証することはできませんそれぞれの複製物サンプルプログラムのいかなる部分またはすべての派生的創作物にも次のように著作権表示を入れていただく必要があります ( お客様の会社名 ) ( 西暦年 ). このコードの一部は IBM Corp. のサンプルプログラムから取られています Copyright IBM Corp. _ 年を入れる _. All rights reserved. プライバシーポリシーの考慮事項サービスソリューションとしてのソフトウェアも含めた IBM ソフトウェア製品 ( ソフトウェアオファリング ) では製品の使用に関する情報の収集エンドユーザーの使用感の向上エンドユーザーとの対話またはその他の目的のために Cookie はじめさまざまなテクノロジーを使用することがあります多くの場合ソフトウェアオファリングにより個人情報が収集されることはありません IBM のソフトウェアオファリングの一部には個人情報を収集できる機能を持つものがありますご使用のソフトウェアオファリングがこれらの Cookie およびそれに類するテクノロジーを通じてお客様による個人情報の収集を可能にする場合以下の具体的事項を確認くださいこのソフトウェアオファリングは展開される構成に応じて ( アプリケーションサーバーが生成する ) セッション情報を収集するセッションごとの Cookie を使用する場合がありますこれらの Cookie は個人情報を含まずセッション管理のために要求されるものです加えて匿名ユーザーの認識および管理のために持続的な Cookie が無作為に生成される場合がありますこれらの Cookie も個人情報を含まず要求されるものですこのソフトウェアオファリングが Cookie およびさまざまなテクノロジーを使用してエンドユーザーから個人を特定できる情報を収集する機能を提供する場合お客様はこのような情報を収集するにあたって適用される法律ガイドライン等を遵守する必要がありますこれにはエンドユーザーへの通知や同意の要求も含まれますがそれらには限られませんこのような目的での Cookie を含む様々なテクノロジーの使用の詳細については IBM の IBM オンラインでのプライバシーステートメント ( のクッキーウェブビーコンその他のテクノロジーおよび IBM Software Products and Software-as-a-Service Privacy Statement ( を参照してください 19 Copyright International Business Machines Corporation 2011, All rights reserved.

20 サポートおよびコメント IBM Worklight の一連の文書トレーニング資料および質問をポストできるオンラインフォーラムはすべて次の IBM Web サイトからご覧になれますサポートソフトウェアサブスクリプション & サポート ( ソフトウェアメンテナンスと呼ばれる場合もあります ) はパスポートアドバンテージおよびパスポートアドバンテージエクスプレスから購入されたライセンスに含まれています International Passport Advantage Agreement および IBM International Passport Advantage Express Agreement の追加情報については次のパスポートアドバンテージ Web サイトを参照してくださいソフトウェアサブスクリプション & サポートが有効になっている場合 IBM はインストールおよび使用法 ( ハウツー ) に関する短期間の FAQ に対するサポートやコード関連の質問に対するサポートを提供します詳しくは次の IBM ソフトウェアサポートハンドブックを参照してくださいご意見本資料に関するご意見をお寄せください本資料の具体的な誤りや欠落正確性編成題材または完成度に関するご意見をお寄せくださいお寄せいただくご意見は本マニュアルまたは製品の情報およびその情報の提示方法に関するもののみとしてください製品の技術的な質問および情報および価格については担当の IBM 営業所 IBM ビジネスパートナーまたは認定リマーケターにお問い合わせください IBM はお客様が提供するいかなる情報もお客様に対してなんら義務も負うことのない自ら適切と信ずる方法で使用もしくは配布することができるものとします IBM またはいかなる組織もお客様から提示された問題についてご連絡を差し上げる場合にのみお客様が提供する個人情報を使用するものとしますどうぞよろしくお願いいたします次の IBM Worklight Developer Edition サポートコミュニティーにご意見をお寄せください IBM からの回答を希望される場合は以下の情報をご連絡ください氏名住所企業または組織電話番号 E メールアドレス 20

21 ありがとうございました 2014 年 6 月 20 日

Module # – <module title>

Module # – <module title> IBM Worklight Foundation V6.2.0 入門 < モジュールタイトル ( 番号なし )> 2014 年 6 月 13 日 US Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp. 商標