PADomainUtils - 전역

  • 릴리스 버전: Xanadu
  • 업데이트 날짜 2024년 08월 01일
  • 읽기7분

    • PADomainUtils API를 사용하면 동일한 인스턴스의 서로 다른 도메인 간에 레코드를 복사 퍼포먼스 분석 할 수 있습니다.

    서버 스크립트에서 이 API를 사용하여 표시기, 세부 항목 및 대시보드와 같은 기록을 다른 도메인에 복사 퍼포먼스 분석 합니다. 이 API를 사용하면 한 도메인에서 기록을 작성 퍼포먼스 분석 하고 해당 기록을 여러 추가 도메인에 복사할 수 있습니다.

    주:
    이 API는 전역 도메인에 기록을 복사할 수 없습니다.
    경고:
    구성 기록이 다른 도메인으로 이동되면 점수에 액세스할 수 없습니다.
    PADomainUtils를 사용하려면 다음 요구 사항을 충족해야 합니다.
    • 퍼포먼스 분석 를 활성화해야 합니다.
    • 스크립트를 실행하는 사용자에게는 관리자 역할이 있어야 합니다.
    • 인스턴스는 도메인 분리를 사용해야 합니다.
    • 스크립트는 전역 도메인에서 실행해야 합니다.
    • 기록을 이동하거나 복사할 때 소스 도메인과 대상 도메인은 서로 달라야 합니다.

    PADomainUtils - PADomainUtils()

    새 PADomainUtils 개체를 인스턴스화하여 전역 도메인에서 레코드를 이동하거나 복사 퍼포먼스 분석 합니다.

    전역 도메인이 아닌 도메인에서 레코드를 이동하거나 복사할 때는 PADomainUtils(String domainFrom) 생성자를 대신 사용합니다.

    표 1. 매개변수
    이름 유형 설명
    없음 
    // PADomainUtils initialized with the global domain
var globalUtils = new SNC.PADomainUtils();

    PADomainUtils - PADomainUtils(문자열 domainFrom)

    새 PADomainUtils 개체를 인스턴스화하여 지정된 도메인에서 레코드를 이동하거나 복사 퍼포먼스 분석 합니다.

    전역 도메인에서 이동하거나 복사할 때 PADomainUtils() 생성자를 대신 사용하십시오.

    표 2. 매개변수
    이름 유형 설명
    domainFrom 문자열 기록을 복사할 도메인입니다. 
    // c90d4b084a362312013398f051272c0d is the sys id of the ACME domain
var acmeUtils = new SNC.PADomainUtils('c90d4b084a362312013398f051272c0d');

    PADomainUtils - 복사(문자열 runAs)

    다른 도메인에 레코드를 복사 퍼포먼스 분석 합니다.

    대시보드 또는 예약된 작업을 복사하려면 copyDashboard 및 copyJob을 참조하세요.

    표 3. 매개변수
    이름 유형 설명
    실행 문자열 기록을 복사하려는 도메인의 사용자입니다.
    표 4. 반환
    유형 설명
    void 
    // copy all the Performance Analytics records from global to user's domain
var pa = new SNC.PADomainUtils();
pa.copy('09ff3d105f231000b12e3572f2b4775d');

    PADomainUtils - copyDashboard(문자열 dashboardId, 문자열 runAs)

    대시보드를 다른 도메인으로 복사합니다.

    표 5. 매개변수
    이름 유형 설명
    dashboardId 문자열 복사할 대시보드의 Sys_id입니다.
    실행 문자열 대시보드를 복사하려는 도메인의 사용자입니다.
    표 6. 반환
    유형 설명
    void 
    //Copy Incident Management dashboard from global to user's domain
var pa = new SNC.PADomainUtils();
pa.copyDashboard('a64b7031d7201100b96d45a3ce610335','09ff3d105f231000b12e3572f2b4775d');

    PADomainUtils - copyJob(문자열 paJob, 문자열 runAs)

    예약된 퍼포먼스 분석 데이터 수집 작업 기록을 다른 도메인에 복사합니다.

    표 7. 매개변수
    이름 유형 설명
    paJob 문자열 예약된 데이터 수집 작업 [sysauto_pa] 기록의 퍼포먼스 분석 sys_id입니다.
    실행 문자열 작업을 복사하려는 도메인의 사용자입니다.
    표 8. 반환
    유형 설명
    문자열 오류가 발생하면 오류 메시지이고, 오류가 없는 경우에는 빈 문자열입니다. 
    // No source domain needs to be set
var pa = new SNC.PADomainUtils();
// copy the '[PA Incident] Daily Data Collection job'
// set the 'run as' of the new record to be the 'acme.itil' user
// first argument is the sys_id of the sysauto_pa record
// the second is the sys_id of the acme.itil user record
pa.copyJob('82ba2023d7101100b96d45a3ce6103cd','797d14341f1310005a3637b8ec8b7010');

    PADomainUtils - isWriteable(문자열 테이블, 문자열 ID)

    테이블 및 sys_id로 식별되는 특정 기록에 쓸 수 있는지 평가합니다.

    표 9. 매개변수
    이름 유형 설명
    테이블 문자열 쿼리할 기록이 포함된 테이블의 이름(예: pa_indicators).
    id 문자열 쿼리할 기록의 sys_id입니다.
    표 10. 반환
    유형 설명
    부울 지정된 기록에 쓸 수 있음을 나타냅니다. 기록이 현재 사용자의 도메인 내에 있는 경우 예를 반환합니다. 기록이 없거나 다른 도메인에 있으면 false를 반환합니다. 
    var pa = new SNC.PADomainUtils();
pa.isWriteable('pa_incidents','cd8125b5140012007665a83e633b028d');

    PADomainUtils - move(문자열 runAs)

    기록을 다른 도메인으로 이동합니다 퍼포먼스 분석 .

    표 11. 매개변수
    이름 유형 설명
    실행 문자열 기록을 복사하려는 도메인의 사용자입니다.
    표 12. 반환
    유형 설명
    void 
    // move all the Performance Analytics records from the global to the customers domain
var pa = new SNC.PADomainUtils();
pa.move('774190f01f1310005a3637b8ec8b70ef')

    PADomainUtils - setFoundation(부울 기초)

    이 방법을 사용하여 하이브리드 도메인 구성에서 기본 기록만 이동하거나 복사합니다.

    일부 유형의 기록은 상위 도메인에서, 일부 유형은 하위 도메인에서 유지관리하여 하이브리드 방식을 구현할 수 있습니다. 일반적으로 상위 도메인에는 기본 기록이 포함되고 하위 도메인에는 위젯과 같은 상위 수준 기록이 포함됩니다. 기초 기록으로 간주되는 기록 유형은 다음과 같습니다.
    • 버킷 그룹
    • 버킷
    • 스크립트
    • 분석 결과 소스
    • 표시기 소스
    • 필터
    • 분석 결과
    • 관리 대상 소스
    • 수동 세부 항목
    • 세부 항목 매핑
    • 세분화 관계
    위젯 및 표시기 같은 다른 퍼포먼스 분석 기록은 기본 기록이 아닙니다. 이 메서드를 false로 설정하여 이러한 추가 기록도 이동하거나 복사합니다.
    표 13. 매개변수
    이름 유형 설명
    토대 부울 이 PADomainUtils 개체에서 기본 레코드만 복사하거나 이동해야 하는지 여부를 나타냅니다.
    표 14. 반환
    유형 설명
    PADomainUtils (영문) 이 함수를 호출하는 개체입니다. 
    var pa = new SNC.PADomainUtils().setFoundation(true);
pa.copy('bb6b58b01f1310005a3637b8ec8b70dd');

    PADomainUtils - setOverrides(부울 재정의)

    기록을 복사하기 전에 이 방법을 사용하여 새 기록의 sys_override 값을 원래 상위 기록으로 설정합니다.

    이 방법을 사용하면 상위 도메인의 레코드를 자동으로 재정의할 수 있습니다. 상위 기록을 재정의해도 상위 기록은 하위 도메인에 영향을 주지 않습니다. 기록을 복사할 때 원본 도메인이 대상 도메인의 상위 도메인이 아닌 경우 sys_override 값을 설정해도 동작에 영향을 주지 않습니다. 기록을 이동할 때가 아니라 기록을 복사할 때만 재정의를 지정할 수 있습니다.

    표 15. 매개변수
    이름 유형 설명
    재정의 부울 하위 도메인의 복사된 기록이 상위 도메인의 원본 기록보다 우선해야 함을 나타냅니다. 이 값은 기본적으로 true입니다.
    표 16. 반환
    유형 설명
    PADomainUtils (영문) 이 함수를 호출하는 개체입니다. 
    var pa = new SNC.PADomainUtils('c90d4b084a362312013398f051272c0d');
pa.setOverrides(false);
pa.copy('bb6b58b01f1310005a3637b8ec8b70dd');