6. 付録 一覧へ 6.2. get_snaoのデータシート
| 設定項目名 | 説明 | 値の例 | 備考 |
|---|---|---|---|
| SnipeIT_API_URL | Snipe-ITのAPIのURL | http://127.0.0.1/api/v1 | 必須項目 |
| SnipeIT_API_KeyFile | Snipe-ITのAPIにアクセスするためのベアラキーを格納したファイル名 | /usr/local/pc-snipe/etc/api.key | デフォルト値は「値の例」に記載の通り |
| SnipeIT_API_Timeout | Snipe-ITのAPIタイムアウトを秒で指定 | 30 | デフォルトは30秒 |
| DNS_Address | Active DirectoryもしくはDNSサーバのIPアドレス | 172.16.30.53 | 空の場合、システムリゾルバを利用する
デフォルトは空（システムリゾルバを利用する）
|
| DefaultCommunity | Snipe-ITの資産情報としてコミュニティ名が登録されていなかったときに使用されるSNMPコミュニティ名 | public | 必須項目 |
| DNS_Domain | Active Directory上で管理されているDDNSのドメイン名 | example.com | PCのIPアドレスを調べるとき、Snipe-ITに登録されているコンピュータ名の末尾に保管される文字列である |
| SnipeIT_SearchWindow | コンピュータ名検索モードで一度に読み込む資産情報数
メモリ使用量の増大を防止するための保護機能
|
100 | デフォルトは100 |
| TemplatePath | 出力情報テンプレートとホワイトリスト・ブラックリストが格納されるディレクトリ
ここで指定したディレクトリ配下に、対象情報ごとに項目名のディレクトリが配置され、さらにその中に実際のファイルを配置する
|
/usr/local/pc-snipe/tmpl | デフォルト値は「値の例」と同じ |
| MappingFile | 情報マッピングファイルのパス | /usr/local/pc-snipe/etc/mapping.conf | デフォルト値は「値の例」と同じ |
| MemorySizeUnit | メモリサイズの単位
K: キロバイト
M: メガバイト
G: ギガバイト
|
M | MemorySizeに適用される
デフォルト値はM
|
| DiskSizeUnit | ディスクサイズの単位
K: キロバイト
M: メガバイト
G: ギガバイト
|
G | DiskSizeとDiskInfoに適用される
デフォルト値はG
|
| MemorySizeDigits | MemorySizeの整数部の桁数
取得した値が指定した桁数以下の場合、左に半角スペースが埋められる
|
6 | デフォルト値は6 |
| DiskSizeDigits | DiskSizeの整数部の桁数
取得した値が指定した桁数以下の場合、左に半角スペースが埋められる
|
4 | デフォルト値は4 |
| CPUThreadsDigits | CPUThreadsの整数部の桁数
取得した値が指定した桁数以下の場合、左に半角スペースが埋められる
|
2 | デフォルト値は2 |
| 項目名 | 表示名の例 | 備考 |
|---|---|---|
| ComputerName | コンピュータ名 | 必須 |
| IPaddr | IPアドレス | 値はSNMPではなく、名前解決により取得 |
| Community | コミュニティ名 | |
| CPUThreads | CPUスレッド数 | |
| MemorySize | メモリサイズ | |
| DiskSize | ディスクサイズ | |
| DiskInfo | ディスク情報 | |
| Appli | インストール済みアプリケーション | |
| CompterInfo | コンピュータ情報 | |
| DeviceInfo | デバイス情報 | |
| NetworkInfo | ネットワークデバイス情報 |
出力テンプレートとホワイトリスト・ブラックリストファイルは、 トップディレクトリ配下にマッピング項目名のディレクトリがあり、 その中に実際のファイルが配置されます。
サンプルでは、次のファイルが用意されています。
tmpl/CPUThreads/template.conf
tmpl/MemorySize/template.conf
tmpl/DiskInfo/whitelist.conf
tmpl/DiskInfo/template.conf
tmpl/Appli/blacklist.conf
tmpl/Appli/template.conf
tmpl/ComputerInfo/template.conf
tmpl/DeviceInfo/template.conf
tmpl/DeviceInfo/blacklist.conf
tmpl/NetworkInfo/template.conf
tmpl/NetworkInfo/blacklist.conf
tmpl/DiskSize/whitelist.conf
| 置換タグ文字列 | 具体的な出力値 | 備考 |
|---|---|---|
| [[CPUThreads]] | HOST-RESOURCES-MIB::hrProcessorFrwIDで取得できた件数
整数部桁数が設定項目MemorySizeDigitsの値に満たない場合、
文字列先頭に半角スペースを必要分埋める
|
CPUスレッド数を表す |
[[CPUThreads]]
| 置換タグ文字列 | 具体的な出力値 | 備考 |
|---|---|---|
| [[MemorySize]] | HOST-RESOURCES-MIB::hrMemorySize.0から
設定項目MemorySizeUnitで指定した単位に応じて割り算した数値の小数点第1位まで
整数部桁数が設定項目MemorySizeDigitsの値に満たない場合、
文字列先頭に半角スペースを必要分埋める
|
[[MemorySize]]
| 置換タグ文字列 | 具体的な出力値 | 備考 |
|---|---|---|
| [[TotalCapacity]] | 下記[[Capacity]]の合計値
ただし、ホワイトリスト、ブラックリストにより非採用の情報については合算から除外される
|
|
[[DiskInfoBegin]]
～
[[DiskInfoEnd]]
|
ループタグ
HOST-RESOURCES-MIB::hrStorage*のどれか値があるもののインデクスについて番号の若い順に展開される
以下の置換タグは、このループタグ内で各インデクスに対応する情報が展開される
|
|
| [[DeviceDescr]] | デバイスの説明
HOST-RESOURCES-MIB::hrStorageDescrから取得する
|
|
| [[Capacity]] | 容量
HOST-RESOURCES-MIB::hrStorageAllocationUnitsとHOST-RESOURCES-MIB::hrStorageSizeを掛け合わせ、単位に応じて割った数値の小数点第1位まで
K：1024で割る
M：1024 * 1024で割る
G：1024 * 1024 * 1024で割る
|
|
| [[Media]] | ストレージタイプ
HOST-RESOURCES-MIB::hrStorageTypeから取得する
opticalDiskROMやhardDiskといった表示がある
|
Total: [[TotalCapacity]] GBytes
[[DiskInfoBegin]][[Media]]: [[Capacity]] GBytes ([[DeviceDescr]])
[[DiskInfoEnd]]
Total: 29.4 GBytes
FixedDisk: 29.4 GBytes (C:\ Label: Serial Number 4241c555)
| 置換タグ文字列 | 具体的な出力値 | 備考 |
|---|---|---|
| [[LastChange]] | 最終変更日時
HOST-RESOURCES-MIB::hrSWInstalledLastChange.0で取得された値を100で割り、現在のUNIXTIMEから減じた日時情報を出力する
書式は「YYYY/MM/DD hh:mm:ss」である
|
|
| [[LastUpdate]] | 最終アップデート日時
HOST-RESOURCES-MIB::hrSWInstalledLastUpdateTime.0で取得された値を100で割り、現在のUNIXTIMEから減じた日時情報を出力する
書式は「YYYY/MM/DD hh:mm:ss」である
|
|
[[AppliBegin]]
～
[[AppliEnd]]
|
ループタグ
HOST-RESOURCES-MIB::hrSWInstalledNameのインデクスについて番号の若い順に展開される
以下の置換タグは、このループタグ内で各インデクスに対応する情報が展開される
|
|
| [[AppliName]] | アプリケーション名
HOST-RESOURCES-MIB::hrSWInstalledNameから取得する
|
|
| [[InstalledDate]] | アプリケーションのインストール日時
HOST-RESOURCES-MIB::hrSWInstalledDateから取得する
書式は「YYYY-[M]M-[D]D,[h]h:[m]m:[s]s.0」である
[]は、1桁の場合1桁で出力されるという意味である
|
Last Change: [[LastChange]]
Last Update: [[LastUpdate]]
[[AppliBegin]][[AppliName]] (installed at [[InstalledDate]])
[[AppliEnd]]
Last Change: 2023-01-19 10:28:03
Last Update: 2023-01-19 10:28:02
Mozilla Firefox (x64 ja) (installed at 2023-1-19,0:55:32.0)
Mozilla Maintenance Service (installed at 2023-1-19,0:55:34.0)
LibreOffice 7.4.4.2 (installed at 2023-1-18,2:46:28.0)
Google Chrome (installed at 2023-1-18,2:49:12.0)
| 置換タグ文字列 | 具体的な出力値 | 備考 |
|---|---|---|
| [[ComputerInfo]] | SNMPv2-MIB::sysDescr.0の値 |
| 置換タグ文字列 | 具体的な出力値 | 備考 |
|---|---|---|
[[DeviceInfoBegin]]
～
[[DeviceInfoEnd]]
|
ループタグ
HOST-RESOURCES-MIB::hrDeviceIndexのインデクスについて番号の若い順に展開される
以下の置換タグは、このループタグ内で各インデクスに対応する情報が展開される
|
|
| [[DeviceType]] | デバイス種別
HOST-RESOURCES-MIB::hrDeviceTypeから取得し、mibmapで変換を行う
|
|
| [[DeviceDescr]] | デバイス名
HOST-RESOURCES-MIB::hrDeviceDescrから取得する
|
[[DeviceInfoBegin]][[DeviceDescr]] ([[DeviceType]])
[[DeviceInfoEnd]]
Microsoft XPS Document Writer v4 (Printer)
Microsoft Print To PDF (Printer)
Microsoft Shared Fax Driver (Printer)
Unknown Processor Type (Processor)
Software Loopback Interface 1 (Network)
| 置換タグ文字列 | 具体的な出力値 | 備考 |
|---|---|---|
[[NetworkInfoBegin]]
～
[[NetworkInfoEnd]]
|
ループタグ
IF-MIB::ifIndexのインデクスについて番号の若い順に展開される
以下の置換タグは、このループタグ内で各インデクスに対応する情報が展開される
|
|
| [[IFType]] | ネットワークインタフェース種別
IF-MIB::ifTypeから取得する
|
|
| [[IFDescr]] | ネットワークインタフェース名
IF-MIB::ifDescrから取得する
|
|
| [[IFMac]] | ネットワークインタフェースに対応付けられたMACアドレス
IF-MIB::ifPhysAddressから取得する
|
[[NetworkInfoBegin]][[IFDescr]] (type: [[IFType]], MAC addr: [[IFMac]])
[[NetworkInfoEnd]]
Intel(R) PRO/1000 MT Network Connection #2-QoS Packet Scheduler-0000 (type: ethernetCsmacd, MAC addr: 56:6f:05:18:03:0d)
Intel(R) PRO/1000 MT Network Connection #2-WFP 802.3 MAC Layer LightWeight Filter-0000 (type: ethernetCsmacd, MAC addr: 56:6f:05:18:03:0d)
Intel(R) PRO/1000 MT Network Connection-WFP Native MAC Layer LightWeight Filter-0000 (type: ethernetCsmacd, MAC addr: 56:6f:05:18:03:0e)
Intel(R) PRO/1000 MT Network Connection-QoS Packet Scheduler-0000 (type: ethernetCsmacd, MAC addr: 56:6f:05:18:03:0e)
Intel(R) PRO/1000 MT Network Connection-WFP 802.3 MAC Layer LightWeight Filter-0000 (type: ethernetCsmacd, MAC addr: 56:6f:05:18:03:0e)
SNMPによって取得される値の中には、 他のMIBへのリンク形式になっている一部情報が リンク先の静的なMIB名の形式で出力されるものがあり、 見た目にも意味が分からないものがあります。 pc-snipeではこれらを見やすい形に変換しています。
| 元の値 | 変換値 |
|---|---|
| HOST-RESOURCES-MIB::hrStorageTypes.1 | Other |
| HOST-RESOURCES-MIB::hrStorageTypes.2 | Ram |
| HOST-RESOURCES-MIB::hrStorageTypes.3 | VirtualMemory |
| HOST-RESOURCES-MIB::hrStorageTypes.4 | FixedDisk |
| HOST-RESOURCES-MIB::hrStorageTypes.5 | RemovebleDisk |
| HOST-RESOURCES-MIB::hrStorageTypes.6 | FloppyDisk |
| HOST-RESOURCES-MIB::hrStorageTypes.7 | CompactDisc |
| HOST-RESOURCES-MIB::hrStorageTypes.8 | RamDisk |
| HOST-RESOURCES-MIB::hrStorageTypes.9 | FlashMemory |
| HOST-RESOURCES-MIB::hrStorageTypes.10 | NetworkDisk |
| 元の値 | 変換値 |
|---|---|
| HOST-RESOURCES-MIB::hrDeviceTypes.1 | Other |
| HOST-RESOURCES-MIB::hrDeviceTypes.2 | Unknown |
| HOST-RESOURCES-MIB::hrDeviceTypes.3 | Processor |
| HOST-RESOURCES-MIB::hrDeviceTypes.4 | Network |
| HOST-RESOURCES-MIB::hrDeviceTypes.5 | Printer |
| HOST-RESOURCES-MIB::hrDeviceTypes.6 | DiskStorage |
| HOST-RESOURCES-MIB::hrDeviceTypes.10 | Video |
| HOST-RESOURCES-MIB::hrDeviceTypes.11 | Audio |
| HOST-RESOURCES-MIB::hrDeviceTypes.12 | Coprocessor |
| HOST-RESOURCES-MIB::hrDeviceTypes.13 | Keyboard |
| HOST-RESOURCES-MIB::hrDeviceTypes.14 | Modem |
| HOST-RESOURCES-MIB::hrDeviceTypes.15 | ParallelPort |
| HOST-RESOURCES-MIB::hrDeviceTypes.16 | Pointing |
| HOST-RESOURCES-MIB::hrDeviceTypes.17 | SerialPort |
| HOST-RESOURCES-MIB::hrDeviceTypes.18 | Tape |
| HOST-RESOURCES-MIB::hrDeviceTypes.19 | Clock |
| HOST-RESOURCES-MIB::hrDeviceTypes.20 | VolatileMemory |
| HOST-RESOURCES-MIB::hrDeviceTypes.21 | NonVolatileMemory |
| 終了コード | 説明 | 備考 |
|---|---|---|
| 0 | 正常終了 | 処理続行 |
| 1 | コマンドライン引数不正 | 続行不能 |
| 2 | 環境設定ファイルの書式エラー | 続行不能 |
| 3 | 情報マッピング設定ファイルの書式エラー | 続行不能 |
| 4 | Snipe-ITの資産タグ検索において、該当資産タグが存在しない | 続行不能 |
| 5 | Snipe-ITのコンピュータ名検索において、該当資産が存在しない | 続行不能 |
| 6 | ADに対するDNSクエリにおいて、該当ホスト名のAレコードが取得できない | 続行不能 |
| 7 | WindowsPCに対するSNMPで情報が1件も取得できない | 続行不能 |
| 8 | テンプレートファイルが存在しない | 続行不能 |
| 9 | コンピュータ名がSnipe-IT登録情報とSNMP取得情報とで異なる | 処理続行 |
| 10 | SNMPで取得したOS名に「Windows」が含まれない | 処理続行 |
| 終了コード | 説明 | 備考 |
|---|---|---|
| 99 | 環境設定ファイルの読み込みエラー | 続行不能 |
| 98 | 情報マッピング設定ファイルの読み込みエラー | 続行不能 |
| 97 | Snipe-ITのAPI実行エラー | 続行不能 |
| 96 | DNSクエリの実行エラー | 続行不能 |
| 95 | SNMPクエリの実行エラー | 続行不能 |
| 94 | テンプレートファイルの読み込みエラー | 続行不能 |
| 93 | ホワイトリストファイルの読み込みエラー | 続行不能 |
| 92 | ブラックリストファイルの読み込みエラー | 続行不能 |
