• 製品
  • 使用を開始する
  • 関連ドキュメント
  • リソース

データ マネージャーを使用する準備はどのようにすればよいですか?

Assets Data Manager for Jira Service Management Cloud is currently rolling out in Open Beta and will be available to all Premium + Enterprise sites by end of October 2024.

  • ユーザー側で必要な操作について

    • ステップ 1 - ツールを決定する

      • CSV ファイル収集に関するその他の注意事項

      • ファイル形式の詳細

    • ステップ 2 - スコープとフィルタリング要件を決定する

    • ステップ 3 - "アダプタ クライアント" と "クレンジングおよびインポート クライアント" のインストール先を決定する

      • データのアップデート

    • ステップ 4 - データや認証情報を取得する

      • CSV ファイルのさまざまなデータ ソース タイプ用に提案されたフィールド

 To get your Data Manager up and running smoothly, you'll need to follow these key steps to prepare your system and data for integration.

Steps to Follow:

  1. Choose the Tools to Connect

  2. Define Your Scope and Filtering Requirements

  3. Install the Necessary Clients

  4. Gather Data and Credentials

Step One - Choose the Tools to Connect

Start by selecting the tools you want to integrate with Data Manager. Limit your initial selection to five tools; you can add more later.

Check if any tools have pre-existing connections. Review this list for details on available connections and what information you’ll need from each tool’s Subject Matter Expert (SME).

Coordinate with each SME to obtain either a comma-separated file (CSV) or specific connection details (like API or database information).

CSV ファイル収集に関するその他の注意事項

ファイル形式の詳細

レスポンス

If using a Flat File, what information should be in the file?

For example, let’s say we're focusing anything with a computer/virtual machine comparison type where you’re checking the coverage between tools.

The Flat File should contain one row for each end-point (computer, server, mobile, etc.).

The columns would contain the standard information that you might look at when buying a laptop (e.g., serial number, operating system, RAM, disk space, etc.).

どのようなフィルターを適用する必要がありますか?

Get an unfiltered extract from the tool. Then, you can perform the filter in Data Manager. Once done, you can check for things like if a status is set incorrectly, which would normally filter out a record from an Asset Management system.

このようなデータが含まれていると、データ マネージャーによってステータスが不適切なレコードが存在することが示されます。

この形式の要件となる重要な詳細は何ですか?

  • It must be a flat file, eg comma separated (CSV) or text (txt). It cannot be an Excel or a Google Sheet etc.

  • A header row is useful, and can be used when setting up to simplify creating attributes.

  • Any date needs to be in the same format per flat file (e.g. dd-mmm-yy). For example: you can’t have a few rows where time is also present.

  • データにスペースが含まれている場合は、修飾子 (列を "" で囲むなど) が必要です。任意の修飾子を使用できますが、その意味を理解しておく必要があります。

  • ファイルの末尾の前に空白行を入れないでください。

Step Two - Define Your Scope and Filtering Requirements

Understand the data coverage of the tools you plan to integrate into Data Manager.

For example, if you're using Active Directory (AD), you need to know how many AD domains your organization has and ensure they align with your ITSM tool, which might cover all domains.

For IT Asset Management (ITAM) solutions, determine what types of endpoints are relevant (for example, laptops, servers) and ensure they match across systems. If your ITAM solution tracks non-computer assets like chairs or desks, you'll need to set up filters in Data Manager to exclude these items, keeping the scope consistent with other systems.

Understand the criteria each system uses to classify data as active or stale. For example, Active Directory might consider data stale if it's over 90 days old, while another tool might have different criteria. Know these rules for each system to ensure accurate data integration. You may need to engage with the tool SME to understand the details.

Step Three - Install the Necessary Clients

You need two apps: the Adapters client and the Cleanse and Import client. Here's how to set them up:

  • Adapters Client: Install this locally on a machine or server within your environment. You can download it via the Atlassian Marketplace. Having the machine in your local environment limits the security exposure between data sources and the internet. The local server will need to be able to see each of your data sources and your Jira Service Management Assets instance. Without the local server, all data sources would be exposed directly to the internet.

  • Cleanse and Import Client: This client should be installed on your local machine or server. It cleanses and imports data before sending it to the Assets Data Manager. This can also be found in the Atlassian Marketplace - . If you're using API or database connections, this client ensures data can be refreshed automatically according to your schedule.

The Adapters Client and Cleanse and Import Client are bundled together on the Atlassian Marketplace download.

When running jobs from the Adapters client and the Cleanse and Import client, you'll need your Token and workspace-ID. You can generate these tokens by:

  • Navigate to your service project and go to Assets > Global Configuration.

  • Select the Data Manager tab.

  • Select the token you want to generate.

Note - the Adapters & Cleanse and Import client tokens are different but created from the same location. The workspace-ID is the same for both clients.

Step Four - Gather Data and Credentials

Connect with your SMEs to obtain database access, API details, or prepare your flat files.

Some out-of-the-box Adapters are ready for Data Manager. The Adapters page provides detailed information on each Adapter, including connection requirements and the data attributes returned to Data Manager.

Suggested Fields for Flat Files

Here are some suggested fields for Flat files, which you can share with your SME as examples of what columns might be needed. The field names and availability may vary based on the tools in your organization. If Data Manager is used for asset or configuration item comparison, aim to include columns marked as "Required = Mandatory."


資産管理

属性

タイプ

AssetName 

文字列

abc123

NumberofCores

整数

4

FlatDomain

文字列

Airtrack.local

IP アドレス

文字列

192.192.1.1

最終更新日

日付

12 August 2020

作成日

日付

15 January 2019

更新者:

文字列

<User Name or Load>

場所

文字列 

Melbourne

製造元

文字列

Microsoft

モデル

文字列

Surface Pro 4

オペレーティング システム

文字列

Windows 11

Service Pack

文字列

1501

Processor Type

文字列

Intel

Number of Processors

整数

2

ComputerRole

文字列

本番環境

Serial Number

文字列

3659834

AssetStatus

文字列

アクティブ

合計メモリ

Big Integer

8096

CMDB (Jira Service Management Assets, ServiceNow etc)

属性

タイプ

必須

OperationStatus

文字列

(必須)

名前

文字列

(必須)

OS

文字列

(必須)

場所

文字列

(必須)

製造元

文字列

(必須)

ModelID

文字列

(必須)

IP アドレス

文字列

(必須)

Serial Number

文字列

(必須)

SysUpdatedOn

日付

(必須)

OS Service Pack

文字列

(必須)

CPU 数

整数

(必須)

RAM/Memory

Big Integer

(必須)

CPU のタイプ

文字列

Desirable

検出ソース

文字列

Desirable

最初の検出

日付

Desirable

SysUpdatedBy

文字列

Desirable

担当者

文字列

Desirable

シャーシ タイプ

文字列

Desirable

サポート グループ

文字列

Desirable

所有者

文字列

Desirable

Managed by

文字列

Desirable

Warranty Expiration

日付

Desirable

System Management or Patching tool (eg SCCM, BigFix etc)

属性

タイプ

必須

シャーシ タイプ

文字列

(必須)

Computer Name

文字列

(必須)

ドメイン

文字列

(必須)

InventoryDate

日付

(必須)

MachineID

文字列

(必須)

製造元

文字列

(必須)

ModelNo

文字列

(必須)

Number of Processors

整数

(必須)

オペレーティング システム

文字列

(必須)

Serial Number

文字列

(必須)

LastLoggedOnUser

日付

Desirable

Full Operating System Version

文字列

Desirable

Operating System Build

文字列

Desirable

Service Pack

文字列

Desirable

合計メモリ

Big Integer

Desirable

Cyber / Security (eg Qualys, Crowdstrike, Rapid-7, MS Defender)

Compute Attribute

タイプ

必須

AgentLocalTime

文字列

(必須)

エージェントのバージョン

文字列

(必須)

BiosManufacturer

文字列

(必須)

ExternalIP

文字列

(必須)

ホスト名

文字列

(必須)

FirstSeen

文字列

(必須)

LastSeen

文字列

(必須)

OS バージョン

文字列

(必須)

ProvisionedStatus

日付

(必須)

Serial Number

文字列

(必須)

CPU 数

整数

(必須)

ステータス 

Big Integer

(必須)

SystemManufacturer

文字列

Desirable

Criticality

文字列

Desirable

Active Directory > Computer

属性

タイプ

必須

accountExpires

日付

(必須)

cn

文字列

(必須)

description

文字列

(必須)

distinguishedname

文字列

(必須)

FlatDomain

文字列

(必須)

lastLogoff

日付

(必須)

lastLogonTimestamp

日付

(必須)

場所

文字列

(必須)

name

文字列

(必須)

オペレーティング システム

文字列

(必須)

オペレーティング システム サービス パック

文字列

(必須)

Operating System Version

文字列

(必須)

QualifiedDomain

文字列

(必須)

sAMAccountName

文字列

(必須)

userAccountControl

文字列

(必須)

whenChanged

日付

(必須)

whenCreated

日付

(必須)

Active Directory > Subnets

Compute Attribute

タイプ

必須

名前 

文字列 

(必須)

場所

文字列

(必須)

説明

文字列

(必須)

サブネット

文字列

(必須)

SolarWinds (Network object class)

Network Attribute

必須

SysName

(必須)

LastBoot

(必須)

最終同期

(必須)

場所

(必須)

NodeDescription

(必須)

PolledStatus

(必須)

ステータス

(必須)

vendor

(必須)

表示名

任意

NodeName

任意

AgentPort

任意

カテゴリー

任意

お問い合わせ

任意

CPU 数

任意

CPU 負荷

任意

説明

任意

DNS

任意

EntityType

任意

IOSImage

任意

IOSVersion

任意

IP アドレス

任意

IP アドレス タイプ

任意

サーバー

任意

Machine Type

任意

MemoryAvailable

任意

MemoryUsed

任意

ObjectSubType

任意

重大度

任意

StatusDescription

任意

SystemUpTime

任意

合計メモリ

任意

Note: If SolarWinds is also discovering Servers, then that information could also be put into the Compute Object.

ユーザー

ユーザー属性

必須

従業員 ID

(必須)

氏名

(必須)

タイトル

任意

任意

Middle Name

任意

任意

アドレス

任意

電話番号

任意

モバイル

任意

メール

(必須)

Alternate email

任意

職位

任意

Employment status

任意

ステータス

任意

Work Location

任意

コスト センター

任意

マネージャー

任意

さらにヘルプが必要ですか?

アトラシアン コミュニティをご利用ください。