macOS アプリケーションの接続¶
Guanceのアプリケーションモニタリングは、各 macOS アプリケーションのメトリクスデータを収集し、可視化された形で各 macOS アプリケーションのパフォーマンスを分析できます。
読み進め方¶
- 初めての接続:まずは クイックスタート をご覧ください
- 完全な接続:引き続き本記事をお読みください
- 初期化パラメータ:SDK 初期化、RUM 設定、Log 設定、Trace 設定 をご参照ください
- カスタマイズ機能:カスタムタグの使用、データ収集カスタムルール をご参照ください
- データモデル:アプリケーションデータ収集 をご参照ください
- 問題のトラブルシューティング:障害調査 をご参照ください
前提条件¶
注意
RUM Headless サービスをすでに有効にしている場合、前提条件は自動的に設定されているため、すぐにアプリケーションを接続できます。
アプリケーションの接続¶
- ユーザーアクセス監視 > アプリケーションを新規作成 > macOS に進みます
- アプリケーション名を入力します
- アプリケーション ID を入力します
-
アプリケーションの接続方式を選択します
- パブリックネットワーク DataWay:RUM データを直接受信します。DataKit コレクターのインストールは不要です
- ローカル環境へのデプロイ:前提条件を満たした上で RUM データを受信します
インストール¶
ソースコード:https://github.com/GuanceCloud/datakit-macos
Demo:https://github.com/GuanceCloud/datakit-macos/Example
Podfileファイルを設定します。
Podfileディレクトリでpod installを実行して SDK をインストールします。
-
PROJECT->Package Dependencyを選択し、Packagesセクションの + をクリックします。 -
表示されたページの検索ボックスに
https://github.com/GuanceCloud/datakit-macosを入力します。これはコードの保存場所です。 -
Xcode がパッケージを取得すると、SDK の設定画面が表示されます。
Dependency Rule:Up to Next Major Version を推奨します。
Add To Project:サポートするプロジェクトを選択します。
設定が完了したら Add Package ボタンをクリックし、ロードが完了するまで待ちます。
- ポップアップ
Choose Package Products for datakit-macosで SDK を追加する Target を選択し、Add Packageボタンをクリックします。これで SDK の追加が完了します。
プロジェクトが SPM で管理されている場合は、FTMacOSSDK を依存関係として追加し、Package.swift に dependencies を追加します。
```swift dependencies: [
.package(url: "https://github.com/GuanceCloud/datakit-macos.git", .upToNextMajor(from: "[latest_version]")) ] ```
ヘッダーファイルの追加¶
詳細設定の入り口¶
高度なシナリオ¶
よくある質問¶
クラッシュログの分析について¶
クラッシュログ分析と dSYM の説明は、障害調査 をご参照ください。
Include of non-modular header inside framework module エラーが発生する場合¶
SDK の .h ファイルが依存ライブラリの .h ファイルをインクルードしているため、以下の設定が必要です。
Target -> Build Settings -> CLANG_ALLOW_NON_MODULAR_INCLUDES_IN_FRAMEWORK_MODULES を YES に設定します。